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About This Guide 


Purpose 


This guide provides the information and instructions needed to create a 
communications symbiont for Unisys Operating System/3 (OS/3). It presents the 
detailed information you need to define an ICAM network and perform the related 
system and terminal operations. 


Scope 
The integrated communications access method (ICAM) is the OS/3 software product 
that enables you to establish, use, and maintain communications among ICAM end 
users. As one of a series, this manual is designed to guide you in programming and 
using ICAM on System 80 models 3 - 6 and 8 - 20. Specifically, this guide describes 


how to define an ICAM network, create a communications symbiont, and start up 
ICAM terminals and workstations. 


Note: This guide does not describe ICAM for the System 80 model 7E. Refer to the 
System 80 Model 7E ICAM Operations Guide (70023908) for that information. 


Audience 


This guide is for system programmers of System 80 OS/3 systems. 


Prerequisites 


Anyone using this guide should be familiar with the concepts of communications 
networks and system operations. 
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About This Guide 


Organization 


vi 


This guide contains six sections and three appendixes, as well as an index: 

Section 1. Introduction 

Describes the interfaces available to your program, what a network definition is, what 
types of networks are available to you, how to use this manual, and certain terms used 
in the manual. 


Section 2. Network Definition Macroinstructions 


Provides the macroinstructions used to define an ICAM network. 


‘Section 3. Defining Your Network 


Shows the different types of network definitions, suggests an order of presentation of 
macros to the system generation process for each type of network, and provides many 
examples of network definitions. 

Section 4. Incorporating ICAM Features into Your Communications System 


Describes some of the more important ICAM features and how you can incorporate 
them into your system. 


Section 5. System Operations 


Describes how to generate and load an ICAM symbiont, initialize the global user 
service task (GUST), and -ommunicate with ICAM from the system console. 


Section 6. Terminal Operations 

Describes how to start up and shut down ICAM terminals and workstations. 
Appendix A. Relating Telcon and ICAM Networks 

Provides supplementary information to help you with Telcon and ICAM generations. 
Appendix B. Configuring UTS 20/30/40/400 and SVT 1120/1123/1124 Terminals 


Provides supplementary information and examples for using the TERM macro when 
configuring UTS and SVT terminals. 


Appendix C. CU/DEV Addresses 


Lists the CU/DEV addresses for specifying IBM ® 3970 emulated terminals on the 
TERM macroinstruction. 





IBM ts a registered trademark of International Business Machines Corporation. 
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About This Guide 





Results 


After reading this guide, system programmers will be able to program and use OS/3 
ICAM. 


Notation Conventions 
The following conventions are used in this guide: 
e ICAM macros and operands are shown in UPPERCASE letters. 


¢  User-supplied variables are shown in lowercase letters in format descriptions and 
in italics within the text. 





© Default values are shaded. 
¢ Optional operands are enclosed in brackets [ ]. 
¢ Braces (} enclose groups of operands from which you choose one. 


¢ Parentheses () in format descriptions indicate literal parenthesis characters that 
must be entered in the code. 


Related Product Information 


The following documents may be helpful in understanding and using the information 
presented in this guide. Throughout this guide, when we refer you to another 
document, use the version that applies to the software level in use at your site. 

OS/3 Installation Guide (UP-8839) 

OS/3 Operations Guide (UP-8859) 

OS/3 System Messages Reference Manual (UP-8076) 

OS/3 Hardware and Software Programming Quick Reference Guide (UP-8868) 


OS/3 Integrated Communications Access Method (ICAM) Technical Overview 
(UP-9744) 


OS/3 Integrated Communications Access Method (ICAM) Utilities 
Programming Guide (UP-9748) 


OS/3 Integrated Communications Access Method (ICAM) Programming 
Reference Manual (UP-9749) 
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OS/3 Integrated Communications Access Method (ICAM) Standard MCP 
Interface Programming Guide (UP-8550) 


OS/3 Integrated Communications Access Method (ICAM) Communications 
Physical Interface (CPI) Programming Guide (UP-9746) 


OS/3 Information Management System (IMS) System Support Functions 
Programming Guide (UP-11907) 


OS/3 Distributed Data Processing (DDP) Programming Guide (UP-8811) 
OS/3 NTR Utility Programming Guide (UP-9502) 
OS/3 Interactive Services Operating Guide (UP-9972) 


System 80 Model 7E OS/3 Integrated Communications Access Method (ICAM) 
Operations Guide (70023908) 
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Section 1 
Introduction 


1.1. Network Definition 


An ICAM network definition is an orderly listing of macroinstructions that specify and 
define your communications network. This set of macros and the MCP parameter 
specifications are submitted to the system generation process of the operating system. 
System generation produces an ICAM symbiont. 


All available network definition macros are described in Section 2 of this manual. 
Select only the macros necessary to define your communications network. All 
available MCP parameters are listed in Section 5 of this manual and are described in 
detail in the OS/3 Installation Guide (UP-8839). 


For each network definition you supply during a system generation, the OS/3 system 
generation process automatically creates a communications control area (CCA) that 
includes all of the queues, tables, work areas, and buffer areas ICAM needs to support 
that network. In addition, the ICAM symbiont provides all of the processing modules 
that ICAM needs to support the networks you specify. 


You can have multiple network definitions in one ICAM symbiont, and you can have 
up to 18 symbionts. (Only one ICAM symbiont can be loaded at a time, however.) 
Many users require only one network definition; therefore, they create only one 
communications control area in their ICAM symbiont and maintain only one ICAM 
symbiont. 


There are two kinds of ICAM networks: dedicated and global. A dedicated network is 
so named because the resources it defines (terminals, queues, process files, etc.) are 
available only to that program that requests a dedicated network. That program 
holds the resources until it releases the network. 


A global network, on the other hand, enables two or more programs to attach 
themselves to the global network concurrently. This allows all programs to share the 
network resources and communicate with each other concurrently; that is, resources 
are globally available and not dedicated to one program at a time. 


UP-9745 Rev. 3 1-1 





Introduction 





1.2. ICAM Interfaces to Your Program 


There are several kinds of ICAM interfaces that you can use to communicate with 
ICAM end users from your program. Each one is designed for certain applications. 
The interface you choose depends on the intended functions of your network. 


1.2.1. Interfaces for Dedicated Networks 


There are three interfaces you can use for dedicated networks. Each interface 
provides your program with a different level of support or with a set of unique 
characteristics. 


e Standard Interface (STDMCP) 


STDMCP isolates your program from the physical aspects of communications. 
ICAM handles all input and output, and you can devote all of your program to 
message processing. 


¢ Transaction Control Interface (TCI) 


TCI is similar to the standard interface, but it is used only to support the 
Information Management System (IMS) and TIP/30. 


Note: For complete details on generating an ICAM network that supports IMS, 
see the IMS System Support Functions Programming Guide (UP-11907). 


® Direct Data Interface (DDD 


DDI is a minimum configuration interface that still handles the physical aspects 
of communications, but your program must direct ICAM activity. Your program 
interfaces directly with the ICAM remote device handlers, thus allowing you to 
design a specialized communications configuration. 


1.2.2. Global Network Definitions 


1-2 


In a global network, multiple programs using different interfaces can use the same 
network concurrently. Therefore, the communications network cannot belong to any 
specific interface. The network is designated as global, and each program is defined 
as an end user with a LOCAP macro to specify its required interface. 


The interfaces permitted in a global network include STDMCP and TCI, which were 
explained in 1.2.1. DDI is not supported in global networks; however, one additional 
interface, the demand mode interface (DMI), is available for global networks. 


DMI is required for users of ICAM interactive services and distributed data processing 
(DDP). Interactive services is described in the Interactive Services Operating Guide 
(UP-9972); and DDP is described in the Distributed Data Processing Programming 
Guide (UP-8811). 
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1.2.3. Special ICAM Interfaces 

ICAM also provides interfaces for special purposes. 

¢ Communications Physical Interface (CPI) 
CPI allows your program to work directly with your single-line communications 
adapter at the physical level for special configurations. This interface is 
described in the JCAM CPI Programming Guide (UP-9746). 

¢ Remote Batch Processing (RBP) 
RBP is an ICAM utility that allows you to submit jobs from a remote station and 
receive output at one or more remote stations. This utility requires a dedicated 


network and is described in the JCAM Utilities Programming Guide (UP-9748). 


e Nine Thousand Remote (NTR) 
NTR is an ICAM utility that allows you to use System 80 as a remote job 
entry/batch terminal to a Series 1100 data processing system. This utility 


requires a dedicated network and is described in the NTR Utility Programming 
Guide (UP-9502). 


_ 1.3. Terminology Used in This Guide 


An ICAM symbiont is a load module composed of many routines linked by your 
network definition and the system generation process. Occasionally, this guide 
discusses one of the ICAM functions; however, when we say a function is performed by 
ICAM, we mean that the function is performed by one or more of the ICAM routines 
contained in the ICAM symbiont rather than by your program. 


Programs you write to solve a problem or process an application (that use 
communications) are known by many names: 


¢ Communications user program 

¢ Communications program 

e User program 

¢ Program 

¢ CUP 

All of the terms listed refer to the applications program that you write using the 
interfaces and other facilities of ICAM. Typically, your applications program accepts 


input messages, processes the data contained therein, stores the results in a file at the 
computer site, or sends the results to a remote destination. 
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Applications programs written for ICAM are no different from any other program you 
might write, except that they use ICAM macros to interface with ICAM. Your 
program can perform any other functions you wish, in addition to its communications 
functions. Therefore, throughout this guide, we refer to the applications program that 
you write simply as your program. 
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Section 2 


Network Definition Macroinstructions 


2.1. General Description 


This section provides the macroinstruction repertoire used to define ICAM networks. 
The macros are in alphabetical order. Each macro description includes a list of 
operands and applicable network types. 


Macro 


BUFFERS 


CCA 


CGRPEND 


CONGRP 


CPSTB 


DCPCHNL 
DISCFILE 


DLIST 


ENDCCA 
EUP 
JRNFILE 


LDTE 
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Description 


Establishes network and activity request packet pools, and 
creates other resources needed by ICAM 


Identifies the beginning of a network, the type of network, 
ICAM features, and journaling requirements 


Indicates the end of a UDLC/NRM configuration group 
definition 


Defines a UDLC/NRM configuration group by indicating a set 
of local and remote stations to be connected to a particular line 


(VLINE) 


Defines the entries in a call progress signal table for a circuit- 
switched public data network 


Specifies DCP channel characteristics 
Defines a disk file for use by ICAM 


Creates a list of destinations (a distribution list) in your 
network 


Indicates the end of a network definition 
Formats output messages to terminals 
Defines a journal file 


Defines the attributes of local data terminal equipment (DTE) 
in a circuit-switched public data network 








Network Definition Macroinstructions 


Macro 


LINE 


LOCAP 
LPORT 
PDN 


PGROUP 


PRCS 


PVC 


RDTE 


SESSION 
STATION 


SUB 


TERM 
TRUNK 


VCGROUP 


VLINE 


22 


Description 


Establishes the characteristics of each communications line in 
your communications network 


Creates a locap file for your programs that use global networks 
Defines a logical path between DCA transport service users 
Defines attributes of a public data network 


Specifies polling groups and polling intervals for remote 
workstations 


Defines a process file for temporary storage of messages 


Defines a permanent virtual circuit on a packet-switched 
public data network 


Defines the attributes of remote data terminal equipment 
(DTE) in a circuit-switched public data network 


Defines a static session in a global network 


Defines the unique characteristics of a station required by a 
UDLC/NRM link level control 


Defines a remote subscriber on a packet-switched public data 
network 


Defines the characteristics of each terminal 
Defines a trunk on a packet-switched public data network 


Defines a virtual circuit group on a DDX or PSS packet- 
switched public data network 


Defines the physical link between two eomputer nodes in a 
multinode global network 
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2.2. How to Specify Buffer Pools, Activity Request 
Packet Pools, and Other ICAM Resources 
(BUFFERS) 


Use the BUFFERS macro to create a network buffer pool, an activity request packet 
pool, and optionally, a link buffer pool and a user data unit control table pool 
(UDUCT). All pools are located within your network communications control area. 
BUFFERS also specifies the number, size, and threshold values for the user data unit 
control tables and link buffer packets for distributed data processing and public data 
networks. You may also specify statistical areas to keep track of ICAM’s use of the 
pools so you can adjust pool sizes according to your needs. 


You need to specify BUFFERS in all network definitions except the communications 
physical interface. It may be specified only once in each network definition. 


Format 
LABEL AOPERATIONA OPERAND 
not used BUFFERS {num,sizeJ]{, thresh] ,ARP=integer 


(a 


[, LINKPAK=(num,sizef,thresh])] 


mF] 
te 


L, STAT=YES) 
{, THOLD=n] 
[ ,UDUCT=(numC, ,thresh])] 





Table 2-1 describes the interface and type of network definition in which you may use 
BUFFERS. It also details the applicability of each operand. The first line in the table 
is the name of the macro preceded by an asterisk (to distinguish it from its operands). 
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Table 2-1. Applicability of BUFFERS Macro and Its Operands 


Macro: _ 
BUFFERS ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
interface 


















Dedicated 
Networks 





Global Networks 
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2 § CMCS (COBOL) 


*BUFFERS 


num 


size 


thresh 


ARP= 


EXPFACT = 


LINKPAK= 


OPCOM= 


RTIMER= 


STAT= 


THOLD= 


UDUCT = 


“Shows macro applicability 


LEGEND: 


R = Required O = Optional — = Not applicable 
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Operands 


num 
Specifies the number of network buffers you want in your network buffer 
pool. The number you need depends on your message traffic, the number of 
lines you have, the interface you are using, and your program. However, 
because ICAM gives priority to output messages, you can usually determine 
the number you need by estimating the maximum number and length of 
output messages that can be in the system at any time. 





Note: Specify num for the direct data interface only if datagrams are to be 
transferred (see notes under size operand). (A datagram is an 
optional message transferred to your program when it is activated by 
a GAWAKE macro.) 


size 
Is the length of your network buffers in 4-byte words. Network buffers are 
used to stage the input and output messages for the TCI and STDMCP 
interfaces. 


When your program is communicating with an interactive terminal, such as 
a UTS 400 or UTS 4000 terminal, you don’t need to fit an entire message 
into a single network buffer; ICAM uses additional network buffers until the 
entire message is accommodated. However, for maximum throughput, you 

@ should specify a value large enough so that 90 percent of your messages fit 
into the first network buffer. 


When your program is communicating with a batch device, such as a card 
reader, a card punch, or a printer, you must make sure each record fits into 
the portion of a network buffer available to you. Usually, this means that 
your network buffer size will be greater than 20 words (80 bytes) for punched 
cards and greater than 33 words for a printer (132 characters), i.e., record 
size plus message header prefix size. 


As you can see in the following illustration, network buffer size is always 
somewhat larger than the size of the message data, or of a record in the case 
of a batch device. ICAM inserts a message header prefix at the beginning of 
the first network buffer and your message fills the remaining space in the 
network buffer. 


NETWORK BUFFERS 





MESSAGE HEADER 
PREFIX 







FROM ICAM 


FROM YOUR PROGRAM (OUTPUT) OR 
REMOTE DEVICE HANDLER (INPUT) 










MESSAGE 
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The message header prefix contains control information used by ICAM. The 
space occupied by the message header prefix varies as follows: 


¢ 88 bytes when main storage queuing is used 

¢ 100 bytes when disk queuing is used 

¢ 112 bytes when journaling is used 

¢ 120 bytes when distributed communications architecture is used 
Subsequent network buffers contain: 

®  16-byte segment prefixes when disk queuing is used 

¢ 12-byte prefixes when disk queuing is not used 


These prefixes are used to link the network buffers when more than one is 
needed to hold your message. Each network buffer is filled with your 
message starting at the first byte following the message header prefix and 
segment prefixes. 


Network buffers are also used to stage input messages for the DMI interface 
(terminals in session with interactive services as well as DDP sessions). In 
this case, the headers are three words long; the remainder of the buffer holds 
text. 


Notes: 


1. Network buffer size must be a minimum of 208 (decimal) bytes (52 
words) when a global network uses dynamic sessions. This size (which 
includes the message header) ensures that any messages generated by the 
OS/3 command language processor, due to attempts by a program ora 
terminal operator to establish a dynamic session, will fit into a single 
network buffer. 


2. You should not specify the num and size operands if your program is 
using the direct data interface unless your program is to receive 
datagrams. If so, you must specify sufficient network buffers to hold all 
datagrams that can be present until they are delivered. All network 
buffers used to hold datagrams contain a 12-byte message header prefix. 


thresh 


Specifies a threshold value that is the minimum number of inactive network 
buffers you will allow before ICAM temporarily stops polling for input. This 
allows ICAM to concentrate on sending output until enough network buffers 
become available to resume input. We suggest you specify a value of 10 to 15 
percent of the number of buffers you specify in the num operand. 
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When thresh is used in conjunction with buffer pool expansion, ICAM 
attempts to expand the buffer pool when the threshold value is reached. If 
ICAM is able to expand the buffer pool, processing continues because more 
buffers are available for use. Otherwise, threshold processing takes place as 
described. 


Notes: 
1. The thresh operand is not used in the direct data interface. 


2. ICAM always checks to see if sufficient buffers are available in the 
network buffer pool without entering threshold processing before it 
honors an output request. If not, your program receives control at its no- 
buffer-available (NOBAV) address, and the output request is rejected. 
This prevents output requests from causing the loss of input messages in 
process when a threshold condition occurs. 


3. You should always specify a threshold of at least enough network buffers 
to hold one message. 


4. Ifyou specify this operand, a threshold for activity request packets is also 
established that is approximately 10 percent of the number of packets you 
specify. 


ARP=integer 
Creates an activity request packet pool. The number you specify is the 
number of 14-word (56-byte) activity request packets available to ICAM to 
perform its functions. 


Activity request packets are essential to ICAM. We recommend the 
following based on the interface you are using: 


Interface Minimum Number of Packets 

Standard 5 per line + 4 per network + 2 per process file 
interface + special functions 

TCI 7 per line + 4 per network + special functions 
DDI 4 per line + 4 per network + special functions 
DMI 1 per active interactive service or DDP session 
DCA sessions 6 + 6 per line + special functions 

Circuit- 6 + 10 per line + special functions 

switched PDN 
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28 
Update A 


Packet- 





Use the following formula. 


switched PDN 
(must be DCA) 


Calculate the number of activity request packets with the formula: 


num = vc + trks + tsess 


where: 


ve 
Is the number of virtual circuits on all packet-switched public data 
networks. 


trks 
Is the number of trunks in the ICAM network. 


tsess 
Is the maximum number of sessions that may be active 
simultaneously on all virtual circuits. 


Special functions: 


e Ifyour program issues multiple output messages to multidrop lines, add P 
one activity request packet for each terminal. @& 





e Ifyou issue a long series of requests to ICAM with IRL set, add one 
activity request packet for each call over 3. 


e Ifyou are using DCA, you must allow six activity request packets for 
ICAM, six for each configured line or DCP channel, and one for each 
session allowed. DMI users should allow three activity request packets 
per interactive services session and three per DDP session. 


EXPFACT= [ n 


25 
Specifies an ICAM buffer pool expansion factor. You may specify 0 to 100 
(percent). The default is 25. 


ICAM automatically expands the number of buffers in a given buffer pool by 
the factor specified in this operand whenever the number of inactive buffers 
in that pool equals the value specified in the thresh operand. This operand 
applies to all ICAM buffer pools (network buffer, ARP, UDUCT, LINKPAK, 
and so on), but only the pool that reaches the threshold value is expanded. If 
the first increment is exhausted, additional increments are added until peak 
requirements are met or main storage resources are exhausted. 


If you specify EXPFACT=0, no buffer pool expansion is performed. However, 

the buffer pool services expansion routine is automatically included in ICAM 

unless you specify BPOOLEXP=NO in the MCP portion of COMMCT at 

system generation (BPOOLEXP takes precedence over EXPFACT). @ 
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LINKPAK=(num, size[, thresh]) 
Specifies the number, size, and threshold value of link buffers. You use 
these with DDP, remote workstation support, public data networks, Telcon 
networks, and processor-to-processor networks. 


Specifies the number of link buffers. 


¢ For DDP, Telcon, processor-to-processor, or circuit-switched public 
data networks, use the following formula to determine the 
maximum number required; then add it to any other link buffers 
needed in the network. 


num = (mpm x maxsess) + 1/2 maxsess 


where: 

num 
Is the number of link-buffers for this network. 

mpm 
Is the number of link buffers required to hold the largest 
message passed over a UDLC/DCPCHNL line. Compute 
mpm by dividing the length of the largest message by the 
value specified in the mxdta parameter on the size of 
formula (rounded to the next whole word). 

maxsess 


Is the maximum number of sessions that will be active on 
a UDLC/DCPCHNL at any given time. 


¢ Fora packet-switched public data network, determine the 
maximum number you need by using the following formula, and 
add to it any other link buffer needs in the network: 
num=(maximum ws or mpm (Whichever is larger) + mpm + ws) x maxsess 
where: 
num 
Is the number of link-buffers for this packet-switched 


public data network. 


ws 
Is the window size. 
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Is the number of data packets required to hold the 
largest message passed over the circuit. Compute mpm 
by dividing the length of the largest message by the value 
specified in the PKTSIZ operand on the PDN macro 
(rounded to the next whole word). 


maxsess 
Is the maximum number of sessions that will be 


multiplexed over this network. 


e¢ When using remote workstations, calculate the minimum number 
of link buffers with the following formula: 


num = 3 x number of TERM macros specified for remote workstations 
size 
Specifies the length of the link buffer in words (one word equals four 
bytes). If you have a mix of line types, use the formulas given and take 
the largest calculated value. 


¢ For remote workstation (RWS), the minimum size is 80 (increase 
size as line speed increases). 


e Ifyou are using DDP, Telcon, processor-to-processor, or circuit- 
switched public data networks, use the following formula: 


size = (prfxhdr + mxdta)/4 
where: 
prfxhdr 
Is the length of the link buffer prefix plus headers (74 
bytes if using a VLINE, 84 bytes if using a DCPCHNL). 


mxdta 
Is an average data size (bytes) to be transmitted. Larger 
output will be broken into segments. 


Converts prfxhdr and mxdta to words. 
e Ifyou are using a packet-switched PDN, try the following formula: 
size = (tbprfx + 2hdr + 3hdr + mxdtay/4 
where: 


ibpr fx 
Is the length of the link buffer prefix (40 bytes). 
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2hdr 
Is the length of the level 2 header (2 bytes). 


3hdr 
Is the length of the level 3 modulus for the PDN (three 
bytes for modulus 8, and four bytes for modulus 128). 


mxdta 
Is the value specified on the PKTSIZ operand of the PDN 
macro. 


Converts all of the above to words. 


thresh ; 
Specifies a threshold value. It is not required for PDNs. For non-public 
data networks, use the following formula: 


thresh = 10% of value specified for num 
Note: num and thresh should decrease as SIZE increases. 


OPCOM= f num 
3 
Specifies the number of operator communication packets used for unsolicited 
key-in messages. Determine this number based on how you operate the 
network. If you use many unsolicited key-ins to ICAM in rapid succession, 
consider increasing this number to more than 3, which is the default. 


RTIMER= num 
a0 
Specifies the number of 3-word timer stack entries used with Telcon, 
processor-to-processor, and DDP. Maximum needed should equal the 
number of ports plus the number of active sessions. The default value is 50. 


STAT=YES 
Creates statistics areas for the network buffer pool, the activity request 
packet pool, LINKPAK, and UDUCT. (See 4.6 for a detailed description of 
the statistics area.) 


THOLD=n 
Specifies a threshold for activity request packets used with the direct data 
interface only. When you use this interface, the thresh operand does not 
apply; if you want a threshold on activity request packets, you must specify 
this operand. The THOLD operand causes a threshold processing module to 
be included in ICAM. Ifyou are sure you will never run out of activity 
request packets, you can omit this operand to save storage. 
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UDUCT=(num, , {thresh]) 
Specifies the number of user data unit control tables, which are always 28- 
word areas that control data transmission and supply information about 
messages (senders, receivers, ports, and sessions) in DDP, remote 
workstation, Telcon, and processor-to-processor networks. 


e For non-RWS configurations, allow at least 1.5 times the maximum 
number of sessions that would be active at any given time. Set the 
thresh value to 3. 


e When using remote workstations, calculate the minimum number of 
user data unit control tables (UDUCTs) with the formula: 


num = 2 x number of TERM macros specified for remote workstations 
and set the threshold number by: 
thresh = 10% of value specified for num 
Examples 
How you specify the BUFFERS macro depends on the interface you are using and 
the activity of your system. The following examples illustrate the use of 
BUFFERS in a standard interface network and a direct data interface network. @ 


The use of BUFFERS in a dedicated transaction control interface is similar to 
that shown for the standard interface. 





Example 1: In this standard interface example, a network buffer pool of twenty- 
five 100-word (400-byte) network buffers is established. A threshold of 3 network 
buffers, and an activity request packet pool of 15 packets and five 21-word (84- 
byte) operator communication packets are requested. 


1 72 





NETW CCA TYPE=(STDMCP) ,PASSWORD=JHB1, x 
EATUR 








8 
LNE1 LINE DEVICE=(UNISCOPE), X 
TYPE=(2000, SWCH, SYNC), 
CALL=2997, x 
INPUT=(PRC1) 
TRM1 TERM ADDR=(28,51), x 
FEATURES=(U400, 1920), x 
- HIGH=MAIN , MEDIUM=MAIN, LOW=MAIN 
PRC1 PRCS LOW=MAIN 
ENDCCA 





2-12 UP-9745 Rev. 3 








UP-9745 Rev. 3 





BUFFERS 





Example 2: In this direct data interface network, 24 activity request packets are 
specified for the activity request packet pool. The pool has a 4-packet threshold. 
Notice that no network buffers are used, which is normal for this interface, except 
when datagrams are sent to your direct data interface program. 








1 72 

NETW =(OPCOM) 

LNE1 LINE DEVICE=(UNISCOPE), x 
TYPE=(2000, SWCH, SYNC), 
CALL=2997 

TRM1 TERM ADDR=(28,51), x 
FEATURES=(U400, 1920), x 


AUX1=(TCS, 73,74), 
AUX3=(TCS,75, 76) 
ENDCCA 


CCA 


2.3. 
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How to Indicate the Start of Your Network Definition 
and Specify General Network Characteristics (CCA) 


The CCA macro identifies the beginning of an ICAM network definition, the type of 
network, and the kind of support you want ICAM to provide in the network. 


You use CCA in all network definitions, and it may be specified only once in each 
network definition. See the ICAM Communications Physical Interface (CPI) 
Programming Guide (UP-9746) for using the CCA macro with the CPI. 


Table 2-2 describes the interface and type of network definition in which you may use 
CCA. It also details the applicability of each operand. The first line in the table is the 
name of the macro itself preceded by an asterisk (to distinguish it from its operands). 


Format 


LABEL 


network- 


name 
PIOCcs 


AOPERATIONA 





OPERAND 


TYPE= f (STDMCP} 
(GBL, ,node) 
(DDI) 
(TCI) 
(RBP 1) 





{,CCAID=identifier] 
[,DCA=YES] 
{,DCPLOAD=YES] 


,DESPACE= [ U 
Y 
N 


[,DUSTERR=INLINE] 


,FEATURES= ( [,AUTOBUF] 
[,DATIME][,MONITOR} 
{,OPCOMI[,BASIC] 
{,OUTDELVI][,RESTARTI(,SEGMENTS] ) 


[,GAWAKE=YES] 
,SRNINIT= ( CRESTARTI[,PERFI 
C, STATIC, JOURN] 


[,ODNR] ) 


[ ,PASSWORD=password] 
{,SAVE=YES] 


continued @ 
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AOPERATIONA OPERAND 





,SIGNON= [ YES 
NO 


[,USERS=number ] 


Table 2-2. Applicability of CCA Macro and Its Operands 


eee | ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 
Dedicated 


Networks 


Global Networks 


Public Data 
Networks 


TCI (IMS) 
STDMCP 
STDMCP 
TC! (IMS) 


gE 
” 


x | CMCS (COBOL) 


*CCA 


label 


CCAID= 


DCA= 
DESPACE= 
DUSTERR= 
FEATURES= 
AUTOBUF 
BASIC 


DATIME 





* Shows macro applicability 

LEGEND: R Required cs 
Oo Optional PS 
- Not applicable 


Circuit-switched 
Packet-switched 


hou 
too 
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Table 2-2. Applicability of CCA Macro and Its Operands (cont.) 


at ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 










Dedicated 
Networks 






Global Networks 












Public Data 





TC! (IMS) 
STDMCP 
STDMCP 
TC! (IMS) 
COBOL 
DCA 





MONITOR 


o o | CMCcs (coBoL) 


OPCOM 









OUTDELV 


RESTART 





SEGMENTS 
GAWAKE= 


JRNINIT = 
JOURN 


ODNR 
PERF 


900 00606€82%8mCMDUCOCOTDC SO iO 


2900000000 0)3 
Networks | 
' 2» © 1 001 00 0 © CO. ao Oo o 


92 9000000 0 0 0 0 


RESTART 


ie) 





STAT 


Oo O09 89 00 0000 00 0.0 


PASSWORD = 
SAVE= 
SIGNON= 


TYPE= 
USERS= 
LEGEND: 
Required CS =  ‘Circuit-switched 


R 
oO Optional -PS = Packet-switched 
- = Not applicable 
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Label 


network -name 
Is al- to 4-character label beginning with an alphabetic character that 
identifies this network. This is the label your program refers to when it 
requests a dedicated network or releases a dedicated network. When you 
use a global network, this is the name the global user service task (GUST) 
needs to activate your global network. 


PIOCS ; 
Required label for a CPI network only. 


Note: ACPICCA must be the last one defined in a multiple CCA generation. 
Operands 


TYPE= 
Indicates the type of network being described. 


TYPE=(STOMCP) 
Indicates this is a standard interface dedicated network definition. 


TYPE=(GBL, ,node) 


GBL 
Indicates this is a standard interface global network definition. 
Two commas must follow the GBL operand. 


node 
Is a1- to 4-character computer node identifier for the computer in 
which this network operates. Any non-null character string that 
begins with an alphabetic character may be specified. This 
identifier must not match the label field of any other macro within 
the network definition. 


TYPE=(DDI) 
Indicates this is a direct data interface network definition. 


TYPE=(TCI) 
Indicates this is a transaction control interface dedicated network 
definition supporting the information management system (IMS). For 
details on generating an ICAM network that supports IMS, see the IMS 
System Support Functions Programming Guide (UP-11907). 


TYPE=(RBP1) 
Indicates RBP support. 


CCAID=identifier 
Is a 1- to 8-character identifier (word, label, code, etc.) to be printed on each 
page of your network definition assembly listing and the summary report at 
the end of the listing. This makes it easier for you to locate your network. 
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DCA=YES 
Indicates support of distributed communications architecture (DCA). This 
operand is also required for all remote workstations and packet-switched 
and the NORDIC circuit-switched public data networks. (Note that you 
must also specify GAWAKE=YES.) 


DCPLOAD=YES 
This operand must be included if a DCP is to be downline loaded or cross- 
channel loaded by ICAM. It also allows ICAM to capture a Telcon dump and 
write it to tape for printing on an 1100/2200 system. See the ICAM Utilities 
Programming Guide (UP-9748) for details. 


DESPACE= 
Specifies the destructive space specification for the control page. This 
parameter applies only to remote workstations, UNISCOPE™ terminals, 
and UNISCOPE-type devices attached to a DCP. 


DESPACE=U 
The destructive space parameter is not to be altered; it remains set as 
previously specified in the control page. This is the default value. 


DESPACE=Y 
The destructive space parameter is set each time ICAM or interactive 
services loads the control page. 


DESPACE=N 
The nondestructive space parameter is set each time ICAM or 
interactive services loads the control page. 


Note: The ICAM destructive space definition is restricted for use by terminals 
located on a cluster controller, which are not loaded with the correct ICAM 
gen specification for DESPACE. To obtain the desired destructive space 
setting, you must manually change the control page specification or use the 
interactive services SCREEN command. 


DUSTERR=INL INE 
Specifies that, if an error occurs during DUST macro processing, all returns 
are inline. If you don’t specify DUSTERR=INLINE and an error occurs 
during DUST processing, ICAM returns control at the NETREQ macro 
ERRET=address you specify. 


Note: The DUSTERR=INLINE specification is correct only when your 
program is coded to match the operand you specify. 


UNISCOPE is a registered trademark of Unisys Corporation. 
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FEATURES= 
AUTOBUF 
Includes automatic line buffering routines to support field-written 
remote device handlers. You should not specify this operand if you are 
using remote device handlers provided by Unisys. This operand is used 
in a CPI. 


BASIC 
Includes a basic (minimum) teletypewriter or UNISCOPE remote device 
handler in ICAM. If you require a more sophisticated version of either 
handler, do not specify this operand. 


DATIME 
Includes the routine necessary for ICAM to date and time stamp all 
queued messages. 


MONITOR 
Specifies that the system activity monitor (SAM) is to be linked into the 
communications control area. This utility accumulates data about your 
system performance. The ICAM Technical Overview (UP-9744) gives 
detailed information on how to use this monitor. 


OPCOM 


Includes routines necessary to support unsolicited console type-ins to 
ICAM. This feature is not supported for NTR networks. 


OUTDELV 
Includes routines to support the ICAM output delivery notice feature. 


RESTART 
Includes disk queuing routines to enable a warm restart. Warm restart 
enables you to have ICAM recover messages from disk storage queues 
in the event of a system failure or if you close a network before all 
messages on disk are delivered. 


SEGMENTS 
Includes routines to support segmented message processing. If you 
need to send or receive messages in discrete segments, you must specify 
this operand. 
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Note: Normally, you are not allowed to split (continue) an operand on a subsequent 
statement. However, because the FEATURES operand is exceptionally long, 
and you might need most or all of its suboperands, special provisions have been 
made to permit you to code it like separate keyword operands. 


For example, you may code: 


1 72 





NET1 CCA = TYPE=(STDMCP) ,DUSTERR=INLINE, 
FEATURES=(AUTOBUF), 
FEATURES=(OPCOM,BASIC), 
FEATURES=(OUTDELV, RESTART), 
FEATURES=(SEGMENTS), 
JRNINIT=CRESTART), 
GAWAKE=YES 


< <— KKK XK 


GAWAKE=YES 
Includes the routines to support the ICAM GAWAKE feature. The 
GAWAKE feature enables any task to activate an ICAM user program that 
has yielded, and to optionally send to the user program a message known as 
a datagram. 





If you want dynamically established sessions in your global network, specify 
this operand. 


JRNINIT= 
JOURN 
Includes journaling routines to capture journal records. Journal records 
contain the full text of messages passing through ICAM plus certain 
control information. 


ODNR 
Includes the routines necessary to produce output delivery notice 
records. These refer to journal records and signify that the referenced 
message was dequeued for delivery to a terminal or a communications 
user program, or that a message was canceled. 


PERF 
Includes routines to maintain line and terminal performance records. 


RESTART 
Includes routines necessary to maintain restart records. ICAM writes 
restart records to a history file to permit disk queues to be rebuilt by a 
journal utility should ICAM fail due to a queuing disk failure. 


STAT 
Includes routines to maintain network buffer and activity request 
packet pool statistics. 
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PASSWORD=password 
Is a1- to 8-character password you specify to further identify this network. 
If you specify a password, you must use it in all requests for this network. 


SAVE=YES 
Saves a copy of this network definition in the system object library ($Y$OBJ) 
file on your system resident volume. If you are going to use this network 
definition in conjunction with a COBOL program (and with the COBOL 
message control system (CMCS)), you must specify this operand. 


SIGNON= 
Indicates whether the terminal user can establish a session by issuing a 
$$OPEN command on a terminal not connected to a DCP without knowing 
the terminal name. This is beneficial for users who are required to operate 
more than one terminal, especially if the session is initiated via an 
interactive services execution profile, menu, or DEFKEY definition. It also 
benefits dial-in users. 


SIGNON=YES 
Indicates that the user cannot use the $$0PEN command to establish a 
session. The user must issue a $$SON command specifying the FROM 
and TO names. The $$SON command is described in Section 6. 


SIGNON=NO 
Indicates that the user can establish a session by issuing the $$0PEN 
command identifying only the TO name (i.e., without knowing the 
terminal name). The $$0PEN command is described in Section 6. 


USERS=number 
This operand applies only to the communications physical interface and is 
the decimal number of physical user programs that will use the physical 
network. 
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Examples 
The following examples show the use of the CCA macro. 


Example 1: A dedicated network definition. 


NETW CCA TYPE=(STDMCP) , DUSTERR=INLINE, PASSWORD=JHB, x 
FEATURES=(OPCOM, OUTDELV) 
BUFFERS 10,64, 1,ARP=24 
Example 2: A global network definition. 
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NET1 CCA TYPE=(GBL, ,S) ,DUSTERR=INLINE , FEATURES=(OPCOM) , GAWAKE=YES 
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2.4. How to Indicate the End of a UDLC/NRM 
Configuration Group (CGRPEND) 


This macro indicates the end of a CONGRP definition. 
Format 
LABEL AOPERATIONA OPERAND 


not used CGRPEND not used 
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How to Configure Groups in a UDLC/NRM Link 
(CONGRP) 


This macro is required whenever the UDLC/NRM link control feature is included in a 
DCA network generation. It defines configuration groups as sets of local and remote 
stations, and each set is connected to a particular line (VLINE). 


Table 2-3 describes the interface and type of network definition in which you may use 
this macro. It also details the applicability of each operand in the macro. The first 
line in the table is the name of the macro itself preceded by an asterisk (to distinguish 
it from its operands). 


Format 





LABEL AOPERATIONA OPERAND 






CONGRP CAT=A 


,TYPE=(UDLC, DCA2) 


,CONNTYP= ¢ [ ACTIVE ,AUTO ) 
PASSIVE 


Table 2-3. Applicability of CONGRP Macro and Its Operands 


Macro: : 
CONGRP 1CAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 





















Dedicated 
Networks 


*Shows macro applicability 
LEGEND: 
R = Required O = Optional — = Not applicable 


Global Networks. 



















TCt (IMS) 
STDMCP 
CMCS (COBOL) 
STDMCP 
TCI (IMS) 
COBOL 
DCA 
Public Data 
Networks 


*CONGRP 


label 





CAT= 


TYPE= 


CONNTYP= 
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Label 


symbol 
Is a required 1- to 4-character label that identifies a configuration group. 


Operands 


CAT=A 
Specifies an NRM configuration group which consists of a single VLINE 
connecting a single local and remote station pair. 


TYPE=(UDLC, DCA2) 
Indicates the link level protocol and network type for this group. 


CONNTYP= (¢ [ ACTIVE ,AUTO ) 
PASSIVE 


Identifies the type of connection processing performed during line 
initialization or in response to a connect request. 


This parameter specifies that the initialization completion notification is 
delayed until an operational mode is established. A local station defined as 
PRIMARY sends an SNRM frame to a remote station. A local station 
defined as SECONDARY opens to receive an SNRM frame. 


When you specify this option for a single-switched VLINE configuration 
type, a physical connection is attempted. After it is completed, the UDLC 
handler initiates “Go Operational” procedures. 


ACTIVE 
Specifies auto or manual dial-out to the remote host. 


PASSIVE 
Indicates that the remote host dials in to the local host (unattended 
answering). 


AUTO 


Identifies the type of connection processing performed by the UDLC 
handler during line initialization or in response to a connect request. 
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How to Create a Call Progress Signal Table for a 
Circuit-Switched Public Data Network (CPSTB) 


When a circuit-switched PDN cannot immediately establish a circuit, it reports this 
status to ICAM as a call progress signal. If you do not wish to use the default values 
given in Table 2-4, you can use this macro to build your own table of actions for ICAM 
to take when the circuit-switched network returns a call progress signal. 


You build your own call progress signal table by defining a series of CPSTB macros. 
You identify the table with a label for the first CPSTB macro and indicate the end of 
the table by specifying the END operand in the last CPSTB macro. 


Table 2-5 describes the interface and type of network definition in which you may use 
this macro. It also details the applicability of each operand in the macro. The first 
line in the table is the name of the macro itself preceded by an asterisk (to distinguish 
it from its operands). 


Format 





OPERAND 


cps= [ n 
(ny ’ Nos n,) 


{, END=cpstb-symbol ] 





LABEL AOPERATIONA 








,NOR= ( f slca-nor ],[{ icam-nor ] ) 
9 Q 


| 
CC eat 
| 


, TBD= { time-before-disconnect } | 
Q 
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Table 2-4. Call Progress Signal Action Default Values 


Cail Progress Signal 


Terminal called 
Redirected call 
Connect when free 
No connection 
Number busy 

Local procedure error 
Selection signal trans- 
mission error 

Access barred 
Changed number 

Not obtainable 

Out of order 
Controlled not ready 
Uncontrolled not ready’ 
DCE power off 

Invalid facility request 
Network fault local 
Call information 
Incompatible user 
Network congestion 
Long-term network 
congestion 
Registration/canceilation 
confirmed 

Redirection active 
Redirection inactive 


ao 
eooo0o0°o 


OSOOONNO 


a 
ooo°o 


qa 
oo 


QDawe Wow os WG ea oo oa eo |) 
NODNONNNDOOAON 
oooo0oo0oo0o0o0o0o0o0°o 


coo = 
coo 8 
000 Oo 





LEGEND: 


NOR - Number of retries (to reestablish connection) 

TBR - Time (in seconds) between retries 

TBD - Time (in seconds) before disconnect (wait for network to respond or clear) 
DCE - Data circuit-terminating equipment 
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Table 2-5. Applicability of CPSTB Macro and Its Operands 


tices ICAM Network } IEAM Network Type and Kind of Program Supported and Kind of Program Supported 


Operand 
Name yobasy 
interface 
pedeated Global Networks 
Networks 










TCI (IMS) 
STOMCP 
STOMCP 
TCI (IMS) 
COBOL 
Public Data 
Networks 








CMCS (COBOL) 








*Shows macro applicability 


LEGEND: 
R = Required O = Optional _- = Not applicable 
Label 
symbol 
Is a 1-to 4-character label that identifies the start of a call progress signal 


table. This label is used only on the first of a series of one or more CPSTB 
macros. 
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Operands 


cPs= 
Specifies the 2-character identification number of the desired call progress 
signal. 


CPS=n 
Specifies a single call progress signal to be handled by ICAM according 
to the parameters specified in this macro. 


CPSs=(ny, nos n,) 
Specifies a series of call progress signals to be handled according to the 
parameters specified in this macro. 


END=cpstb- symbol 
Specifies that this is the last CPSTB macro in a series of one or more CPSTB 
macros. You must specify the label of the first CPSTB macro. 


NOR=slca-nor 
Specifies the number of times (0-63) the single line communications adapter 
(SLCA) shall attempt to reestablish a connection to the remote data terminal 
equipment. Zero is the default. 


NOR=icam-nor 
Specifies the number of times the ICAM system shall attempt to reestablish 
a connection if the SLCA fails to reconnect. The range is 0 to 32,767. Zero is 
the default. 


TBR=slca-tbr 
Specifies the time in seconds (0-255) between retries by the SLCA to 
reestablish a connection to a remote data terminal equipment. Zero is the 
default. 


TBR=icam- tbr 
Specifies the time in seconds (0-254) between retries by ICAM to reestablish 
a connection to a remote data terminal equipment. Zero is the default. 


TBD=t ime-before-disconnect 
Specifies the time in seconds (0-254) that ICAM will wait following a call 
progress signal where the data terminal equipment is expected to wait (01, 
02, 03 in Table 2-4) before terminating the connection to a public data 
network. Zero is the default. 
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TABX CPSTB CPS=03, TBD=60 
CPSTB CPS=21,NOR=(10,), TBR=(30,0) 
CPSTB CPS=(45,46) ,NOR=(30, 2), TBR=(5) 
CPSTB CPS=61,NOR=(2, 10), TBR=(10,60) 
CPSTB CPS=71,NOR=(, 10), TBR=(, 1800) , END=TABX 


Call Progress Signal 


Connect when free 
Number busy 
Controlled not ready 
Uncontrolled not ready 
Network congestion 
Long-term network 
congestion 


eooo00o°o 
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How to Specify DCP Channel Characteristics 
(DCPCHNL) | 


The DCPCHNL macro generates a link vector table that enables ICAM to record and 
control the Telecon DCP channel activity. One DCPCHNL macro is required for each 
Telcon front-end processor connected to the System 80 model 8, 10, 15, or 20. 


Table 2-6 describes the interface and type of network definition in which you can use 


this macro. It also details the applicability of each operand in the macro. In the table, 
the name of the macro is preceded by an asterisk (to distinguish it from its operands). 


Format 






AOPERATIONA OPERAND 





LABEL 





CNID=channel -number , 
1D=subchannel - address, 
REMOTE=destinat ion-node 


channel - DCPCHNL 


name 








Table 2-6. Applicability of DCPCHNL Macro and Its Operands 


eee ai iCAM Network Type and Kind of Program Supported 
Olrect 
Dedicated 
Data Global Networks 
Interface CRESS | etebarwenwore | 
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channei-name 


CNID 







ID 





REMOTE 


Pi 
vu 
00000 STOMCP 





*Shows macro applicability 


LEGEND: 
R= Required O-2 Optional - = Not applicable 
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Label 


channel -name 
Specifies a 1- to 4-character identifier of the channel connecting OS/3 to the 
DCP. This name must be the same identifier specified in the LINE operand 
of the associated LPORT macros and used in console commands relating to 
this channel. 


Operands 


CNID=channel -number 
Specifies the channel number in the range of 1-6 as specified in the CACH 
macro of COMMCT. 


Note: 1, 2, 3, 6, and 7 are valid channel numbers for the models 8-20. 


ID=subchannel - address 
Specifies the control unit address as specified for the reporting line number 
in the CACH macro of COMMCT. This address is strapped by a customer 
service engineer into a memory board of the channel interface in the DCP 
according to your request. Although the value is strapped in hexadecimal, it 
is specified in decimal for ID= with valid values of 8 to 15. 


REMOTE=dest ijnat ion-node 
Specifies a 1- to 4-character name for addressing the Telcon front-end 
processor connected to the System 80 host. The name must be the same as 
the name field of the Telcon DCPTS statement. 
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2.8. 


How to Create Disk Buffering and Disk Queuing Files 
(DISCFILE) 


The DISCFILE macro creates a disk file for use by ICAM. You can specify two types 
of ICAM disk files: 


¢ You use the DISCFILE macro with the MSGSIZE operand to specify a disk 
buffering file. This file is required with the transaction control interface. It is not 
used with the standard interface. 


¢ You use the DISCFILE macro with the FILEDIV operand to specify a disk 
queuing file. This file is optional with the standard interface or a transaction 
control interface. 


The allocation and uses of ICAM disk files are described in more detail in 4.2. 
DISCFILE macros should be grouped together following the CCA, BUFFERS, LINE, 
and TERM macros. In a transaction control interface, the DISCFILE macro must 
follow the last TERM macro. In a disk queuing network, the first DISCFILE macros 
must follow at least one PRCS, TERM, VLINE, or PDN macro. 


Table 2-7 describes the interface and type of network definition in which you may use 


this macro. It also details the applicability of each operand in the macro. In the table, 
the name of the macro is preceded by an asterisk (to distinguish it from its operands). 


Format 





AOPERATIONA OPERAND 





LABEL 










MSGSIZE=n 
FILEDIV=n - { MEM } | [, VERIFY=YES] 





file-name DISCFILE 


m 
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Table 2-7. Applicability of DISCFILE Macro and Its Operands 













Macro 
DISCFILE ICAM Network } IEAM Network Typ and Kind of Proram Supported | and Kind of Program Supported 


Operand Ficadceivetune 
Name Data 
interface ati 
waren Global Networks 
Networks 
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*Shows macro applicability 








LEGEND: 


R = Required O = Optional — = Not applicable 
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Label 


file-name 


DISCFILE 


Is a1- to 7-character name identifying this disk file. This name must match 
the file name on an LFD statement in your program’s job control stream. 


Operands 
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MSGSIZE=n 


This operand is required for a disk buffering file and is used only with IMS. 
Gives the size, in bytes, of the largest input message. 


FILEDIV=n 


This operand is required for a disk queuing file and is used with a standard 
interface or transaction control interface. It gives the percentage of disk 
queuing space to be allocated for a control area. There are two ways you can 
determine the percentage to allocate for a control area. In either case, the 
percentage you specify must equal at least one disk track. If you fail to 
provide sufficient file space, you will be canceled with an error code of 480. 


1. 


Rule of thumb estimate: 


Number of disk buffers Approximate FILEDIV allocation 


Under 300 10-20% (depending on number 
. of queues) 
300-1000 5% 
1000-3000 3% 
Over 3000 1-2% 
Note: If you allocate only one cylinder for the disk queuing file, specify 
at least 15 for FILEDIV. 
Calculated percentage: 


The control area requires the following: 

e one 256-byte sector for every 2000 disk buffers in the file 
¢ one sector for each queue using the file 

¢ one sector for file descriptor records 

Use the following formula to calculate the percentage: 

FILEDIV % = # sectors needed for control area 


total # sectors in file 
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Example 1 (large file): Assume that buffer size is 128 words, or 512 
bytes, the size of two sectors. This means that a file holding 5000 disk 
buffers is 10,000 sectors in size. (See 4.2 for information on determining 
file size.) 


File holds 5000 buffers: 5000/2006 (rounded up)= 3 sectors 
24 queues use the file= 24 sectors 
Needed for file descriptor records = 1 sector 
Number of sectors needed 28 sectors 
Size of file 10,808 sectors 


28/10,08@ (rounded up) = 1% 


Example 2 (small file): Assume that buffer size is 64 words, or 256 
bytes, the same size as a sector. The file holds 140 disk buffers and is 
140 sectors in size. 


File holds 140 buffers: 1408/2080 (rounded up) = 1 sector 
1@ queues use the file = 1@ sectors 
Needed for file descriptor records = 1 sector 
Number of sectors needed 12 sectors 
Size of file 148 sectors 





12/148 (rounded up) = 10% 


Note: If the number of sectors needed is less than one cylinder of your disk 
volume, allocate one cylinder and specify at least FILEDIV=15. 


THRESH= 
Enables ICAM to operate main memory queuing and disk queuing 
interchangeably, depending on the availability of inactive network buffers. 


THRESH=MEM 
Specifies that ICAM should use the threshold value calculated at 
network generation time to determine the mode of operation (main 
memory queuing or disk queuing). ICAM derives the value from the 
threshold on the BUFFERS macro. 
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THRESH=m 
Specifies the value for ICAM to use in determining the mode of 
operation. If the number of inactive network buffers equals m, disk 
queuing is initiated. The suggested value is approximately 20 percent 
of the number of buffers declared on the BUFFERS macro. 


Examples: 


disc-f1  DISCFILE FILEDIV=10,THRESH=MEM 
disc-f2 ODISCFILE FILEDIV=15, THRESH=30 


VERIFY=YES 
Specifies verification or parity checking of each block written to a disk 
queuing file. Include this operand if you must be certain that messages 
written to the disk queuing file are complete and accurate. 
Examples 
The following are examples of DISCFILE macros. 
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BUFFILE DISCFILE MSGSIZE=1024 
DQFILE DISCFILE FILEDIV=1@,VERIFY=YES 
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2.9. Howto Create Distribution Lists (DLIST) 


This macro enables you to specify a static list of message destinations within your 
network definition. An output request that references a DLIST is the equivalent of 
multiple output requests that reference every destination in the DLIST. The 
destinations you specify may include process files, LOCAP files, terminals, or other 
DLISTs. Specified DLISTs cannot themselves contain DLISTs. A DLIST created 
within a network is unchangeable for the life of the network. 


Table 2-8 describes the interface and type of network definition in which you may use 
this macro. It also details the applicability of each operand in the macro. The first 
line in the table is the name of the macro itself preceded by an asterisk (to distinguish 


it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
dl ist-name DLIST destination1,destination2,... 


Table 2-8. Applicability of DLIST Macro and Its Operands 





ee ICAM Network Type and Kind of Program Supported 


Operand Direct 


Name Data 


Interface 
Dedicated 


Networks 


Global Networks 


TCI (IMS) 
STDMCP 
STDMCP 
TC! (IMS) 


£ 

4 
°% 
21s 
26 
3 

aa 


CMCS (COBOL) 


*DLIST 


label 


dest-1 


dest-2 


dest-n 





*Shows macro applicability 





LEGEND: 
R = Required O = Optional — = Not applicable 
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Label 


dlist-name 
Is a 1- to 4-character name you assign to this distribution list. 


Operands 
destination1,destination2,... 
Identify at least two destinations, which may be process files, LOCAP files, 
other distribution lists, or terminals. 
Notes: 
1. Youcan incorporate DLIST macros in your communications user program; 
however, you must include at least one DLIST macro (with two valid destinations) 
in your network definition. You must do this, even if you don’t use it. This is to 


incorporate DLIST processing code into ICAM at system generation time. 


2. Adestination name may appear only once in a DLIST or a group of DLISTs in the 
scope of a PUTCP request, or a message processing routine ROUTE macro. 


3. Unpredictable results occur if a DLIST is used to send output to an auxiliary 
device not on line. 


4, Youcannot nest a DLIST more than once; in other words, a DLIST referenced by a 
DLIST cannot reference a third DLIST. 

Example 
The following example shows the use of three DLIST macros. Note that the first 
line references the other two distribution lists. Also, no destination name is 
duplicated in the three macros. 
1 72 
DLT1 DLIST TER1,TER2,DLT2,PFL1,PFL2,DLT3 


DLT2 DLIST TER3,PFL3,LOC1,LOC2 
DLT3. DLIST TER4,LOC3 
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ENDCCA 


2.10. How to Indicate the End of Your Network 


2-40 


Definition (ENDCCA) 


This macro indicates the end of a network definition. 


Format 
LABEL 


not used 


AOPERATIONA 


ENDCCA 


OPERAND 


not used 
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2.11. How to Specify an End User Profile (EUP) 


This macro generates a profile containing the criteria used by the ICAM message 
format editing facility (format edit) to edit output messages. 


Table 2-9 describes the interface and type of network definition in which you may use 
this macro. It also details the applicability of each operand in the macro. The first 
line in the table is the name of the macro itself preceded by an asterisk (to distinguish 
it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
{symbol} PRFN=profile-number 
,EUF= | DCT 
TTY 
U64 
U8@ 
(lwl, lines][,RET]) 


{,E0T=char 
C,ETB=(chyl,choiL,chg})] 
[,CMWO=YES} 
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Table 2-9. Applicability of EUP Macro and Its Operands 


pala ICAM Network | NOAM Network Type and Kind of Proaram Suppored | and Kind of Program Supported 


Operand Direct 
Name poole 
Interface 
eens Global Networks 
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*Shows macro applicability 


LEGEND: 


R = Required O = Optional — = Not applicable 
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Operands 


EUP 


PRFN=profile-number 


EUF= 
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Assigns a number to this profile and associates it with an assignment in one 
related TERM macro. For example, if you identify this profile as 5 
(PRFN=5), then you must specify PROFIL=5 in the associated TERM macro 
that uses it. This number must be unique in your network definition, even if 
an identical profile definition is used with another terminal. 


Describes the page and line profile created. 


EUF=DCT 
Establishes a line width of 132 characters and 54 lines per page for the 
DCT 500 series terminals. 


EUF=TTY 


Establishes a line width of 72 characters for teletypewriter terminals. 
There is no limit on the number of lines per page (continuous). 


EUF=U64 
Establishes a line width of 64 characters for UNISCOPE terminals. 
There is no limit on the number of lines displayed (continuous). 


EUF=U8 
Establishes a line width of 80 characters for UNISCOPE terminals. 
There is no limit on the number of lines displayed (continuous). 


When one of these EUF options (DCT, TTY, U64, or U80) is specified, format 
editing avoids splitting contiguous character strings by scanning each line 
from right to left for a character specified in the EDT operand. If one is 
found, the data to the left is output as a line. If no EDT character is 
specified, the space character (40/*) is used. DICE sequence characters are 
not included in the line width count. If you never want a line to be broken, 
you can specify an EDT character that you know will never be found. 
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EUF=(twi,lines][,RET]) 


lw 
Specifies the number of characters sent in a single line. It may be 
specified with or without the lines subparameter and is used to 
specify line widths different from those already discussed. 


When lw is used in conjunction with the ETB or EDT operands, 
output is transmitted when any of the arguments are satisfied. 
Note that when you specify Jw, any DICE character sequences are 
included in the line width count. 


lines 
Specifies the number of lines output before format edit inserts a 
home paper DICE sequence or returns control to your program. 
Home paper occurs after the number of lines specified, regardless 
of the number of messages it takes to reach the value. If you do not 
specify the RET suboperand, a home paper DICE is issued when 
the lines suboperand is satisfied. This suboperand cannot be 
specified without the Jw suboperand. 


RET 
Returns control to your program after the number of lines specified 
in the lines suboperand are sent. The output delivery notice 
request feature must be specified in your network definition. 


If a message contains additional data after the number of lines 
specified has been sent, the additional data is lost. No notice of 
this is sent to your program. 


When this option (EUF=(lw [,lines] [,RET])) is specified, format editing 
avoids splitting contiguous characters by scanning each line from left to right 
for a character specified in either the EDT or ETB operands. If both an EDT 
and ETB character are found, the EDT character gets the priority. If neither 
is specified, the Jw parameter takes precedence. 


EDT=char 
Specifies a single hexadecimal character used as follows: 


© To determine the length of an output line. When lw, ETB, and EDT 
operands are used in combination, line composition ends when one of 
the operands is satisfied. 


e ~=6 As a line editing argument when EUF=DCT, EUF=TTY, EUF=U64, or 
EUF=U80 is specified. After the line is initially composed according to 
the line width for the terminal specified, editing scans from right to left 
to avoid splitting contiguous characters between output lines. If EDT is 
not specified, editing scans for a space character, hexadecimal 40. 
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e When specified as 10, it may be used in conjunction with ETB to 
identify a 4-character DICE sequence for determining the length of a 
line. The 4-character sequence is never transmitted. 


Note: The EDT operand must.be specified in hexadecimal without an X or 
surrounding apostrophes. For example, X05’ would be 05. 


ETB=(chyL,chy]L,chg]) 


Specifies a 1- to 3-character hexadecimal sequence that indicates the end of a 
line in addition to or instead of the character defined in the EDT operand or 
the jw suboperand. Format edit searches each message from left to right, 
and when an ETB sequence is found, the line is sent to the terminal. The 
ETB sequence that was found in the message is not sent. Note that this 
operand may only be specified when the Jw suboperand is specified. 


Note: The ETB operand must be specified in hexadecimal without an X or 
surrounding apostrophes. For example, X05’ would be 05. 


CMWO=YES 


Causes the computer message waiting sentinel present in an output message 
not to be transmitted. This enables a message to be displayed at certain 
terminals without operator intervention. 


Programming Notes 

1. Each EUP macro must immediately follow its associated TERM macro in 
your network definition. 

2. Each EUP macro profile must relate to only one TERM macro. 

3. Format edit deletes all characters specified by EDT and ETB operands. 
Program-generated data not specified as editing parameters are forwarded 
to the device handler. 

4, DICE sequences found in a message that you specified by EDT and ETB 
operands are discarded and are not sent to the terminal. 

5. Format edit automatically retries output messages in case of trouble. If it 
can’t transmit a message, it returns the status to ICAM, and ICAM reissues 
the entire message. (You may get a reprint of several lines already 
successfully delivered.) 

6. When EUF=DCT, TTY, U64, or U80 is specified and a line contains more 


than one EDT character, only the first EDT character encountered is 
recognized as a line delimiter and is deleted. Other EDT characters on a line 
scanned from right to left are printed out as text characters. 
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Examples 


The following six examples illustrate the use of the EUP macro. It is assumed 
that the PROFIL operand in the related TERM macro is 1. 


Example 1: This example assumes the values supplied by the macro for 
EUF=DCT are adequate. The format edit routine attempts to avoid splitting 
contiguous character strings by searching for a space character, from right to left, 
after generating a line width of 132 characters. After 54 lines are transmitted, a 
home paper control sequence is transmitted and output continues. 

EUP PRFN=1,EUF=DCT 
Example 2: This example is the same as example 1, except that lines are 
constructed on the basis of 132 characters or on the occurrence of the first FF 16 
character. The FF is not transmitted. 

EUP PRFN=1,EUF=DCT,EDT=FF 


Example 3: This example is similar to example 1, except that no attempt is made 
to avoid splitting of contiguous character strings. 


EUP  PRFEN=1,EUF=( 132,54) 


Example 4: This example shows output is 80-character lines. When 16 lines are 
sent, a home paper sequence is issued. 


EUP PRFN=1,EUF=(8@, 16) , CMWO=YES 


Example 5: This example is in error. You cannot specify an ETB sequence unless 
you also specify the /w subparameter. 


EUP PRFN=1,EUF=TTY,ETB=(AA) 
Example 6: This example shows that 80-character lines are sent to the 
UNISCOPE terminal. A new line is composed if hexadecimal FF is found. If no 
FF is found, the EDT parameter is superfluous since the UNISCOPE terminal 
will block on 80-character lines. 


EUP PRFN=1,EUF=U8@, EDT=FF 
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2.12. How to Create Journal Files (JRNFILE) 


The JRNFILE macro creates a journal file. During execution of your program, ICAM 
writes cold restart and report producing records to this file for later processing by the 
journal utility program (JUST). Refer to 4.4 for a description of journaling and a 
sample network definition for a system that supports journaling. 


Table 2-10 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 







LABEL AOPERATIONA OPERAND 


TYPE= ( [SAT] |, [ TAPE ) 
{ DISC } 
(oa ( | { number } = { :"h | ) | 
4 A 





filename JRNFILE 
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Table 2-10. Applicability of JRNFILE Macro and Its Operands 


Macro: ICAM Network Type and Kind of Program Supported 
JRNFILE 


Operand Direct 
Name ‘Data 
Interface 


ODI 
NTR 
RBP 
RPG 
DES 
















Dedicated 
Networks 





Global Networks 








TCi (IMS) 
STDMCP 
TCt (IMS) 


Networks 





tPublic Data 





© | CMCSs (COBOL) 


Oy Oa) 2 STDMCP 


Oo 
io) 





*JRNFILE 


aD 
D 
pel 





label 


o) 
(o) 
° 


TYPE= 







BUFF = 
*Shows macro applicability tPacket-switched only 
LEGEND: R = Required O = Optional - = Not applicable 
Label 
filename 


Is the logical filename. This label identifies the journal file and is required. 
It is referenced by (and must be identical to) the following: 


e the filename operand of the MPPS JOURN macro 


¢ the filename on the LFD statement in the job control stream to execute 
your communications user program (not the utility program that prints 
journal reports) 
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Operands 





TYPE=(SAT DESC) 
Journal file is a disk system access technique (SAT) file. Standard labels are 
assumed. 


TYPE=(SAT, TAPE) 
Journal file is a tape SAT file. Standard labels are assumed. 


BUF F=( 








number {, 10243}, [ thresh 
{| ie de 


_ Creates staging areas in which records are constructed for output to the 
journal file. 


number 
Number of staging areas required for this file. The permitted values are 
from 3 to 10; the default is 3. In most cases, 3 staging areas are 
adequate. You may need more staging areas for a tape journal file or if 
some of your messages are very large. 


1024 
Size of each staging area, in bytes. 


thresh 
Specifies the minimum number of inactive staging areas permitted. 


The permitted values are from 0 to the number of staging areas 
specified; the default is 1. 


Example 


1 72 


JOURN1  JRNFILE TYPE=(SAT, TAPE) ,BUFF=(5, 1024,2) 
JOURN2 JRNFILE 


The first JRNFILE macro specifies a tape journal file and allocates five 1024-byte 
staging areas with a threshold value of 2. 


The second JRNFILE macro assumes all default values. The journal file is on 
disk; three 1024-byte staging areas are allocated, with a threshold value of 1. 
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2.13. How to Define Local Data Terminal Equipment 
L 1d aia Public Data Network 


This macro defines the attributes of local data terminal equipment (DTE) in a circuit- 
switched public data network (PDN). 


Table 2-11 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
symbol [LADDRESS=number ] 


{,CPSTBL=cpstb-name] 


hag) 
] 


, LGROUP= { 
,OUTBARD= f NO 
{ ves | 


(m,n) 
2 
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Table 2-11. Applicability of LDTE Macro and Its Operands 










Macro: 
LDTE. 


Operand Direct 
Name Bae 
Bae 
Dedicated Global Networks 
Networks 










ICAM Network Type and Kind of Program Supported 






TCI (IMS) 
STOMCP 
STOMCP 
TCI (IMS) 
COBOL 
Public Data 
Networks 














CMCS (COBOL) 


ADDRESS = 


INID= 


CPSTBL= 


OUTBARD= 


LGROUP = 


"Shows macro applicability 


: LEGEND: 


R Required O Optional - = Not applicable 


Label 


symbol 
Specifies the 1- to 4-character label of this macro. 


Operands 
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ADDRESS=number 


Specifies the address (calling number) of this local DTE. This operand is not 


required but can be used for documentation purposes. 
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CPSTBL=cpstb- table-name 
Specifies the label (symbol) of the CPSTB macro that defines the call 
progress signal used for this local DTE. If you do not specify this operand, 
the defaults specified in Table 2-4, the call progress signal table, are used. 


INID=NO 
Specifies that incoming calling line identification is not validated. 


INID=YES 
Specifies that ICAM is to validate calling line identification for all incoming 
calls to this local DTE. 


LGROUP= { (m,n) 
(1,6) 
Indicates the number of lines available for this local DTE and the number of 
these lines that are reserved for receiving calls only. This keyword may be 
specified only for connections with UTS 20X terminals. 


m 
Indicates the number of lines in this local DTE; the default is 1; m must 
match the number of CACH macros with the LDTE parameter. 
n 
Indicates the number of lines in this local DTE reserved for incoming 
calls; the default is 0; m must not be greater than m. 
OUTBARD= 


This feature is used with DTE intended for incoming calls only. It bars 
outgoing calls to make the DTE available for receiving calls only. This 
keyword may be specified only for connections with another computer. 


OUTBARD=NO ; 
Specifies that outgoing calls are allowed (not barred) by this local DTE. 


OUTBARD=YES 
Specifies that outgoing calls are barred by this local DTE, which is 
available for receiving calls only. 


OUTID=NO 
Specifies no validation of called line identification for outgoing calls. 


OUTID=YES 
Specifies that ICAM is to validate all called line identification for outgoing 
calls from this local DTE. The PDN reports the called number to ICAM 
before making a connection, and this provides a check that the PDN has 
correctly interpreted the called number. 
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2.14. How to Specify Line Characteristics (LINE) 


Use the LINE macro to specify the characteristics of each local line in a dedicated or 
global communications network. These characteristics include the general type of 
remote device handler needed to support the terminals on the line, the features of the 
line, and the queue arrangements used by terminals on the line. One instruction must 
be coded for each communications line. 


Line queuing (an output option) must not be used in a global network. Therefore, for 
a global network, do not specify the LOW, MEDIUM, and HIGH keywords in the 
LINE macro; specify the output queues you need in the appropriate TERM macro. 
Table 2-12 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 
Format 

LABEL AOPERATIONA | OPERAND 

Line-name 


EaCoLC 


DEVICE=| (BSC, f[line-buffer-length] |, fAsciI {, INTER) 
216 
TRANSCOD 


(DCT2EM |, [ 84 ) 
132 

(DCT2000 |, [ 84 ) 
132 


(DCT475) 


(DCT500 {a 





CINV3271) 

CLWS , KA) 

(MAP5RDH) 

CRDHAL ,RDHBIC,RDKCIE,RDHD}) 
(RWS) 





continued 
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LABEL AOPERATIONA OPERAND 


DEVICE=| (TTYEM) 
(cont.)] CUNESCOPEC,KA1) 
(UTSX) 
(1004) 
(1004EM) 
(3271) 
(9200) 
(9300) 


[,CALL=phone-number ] 

[, CHAN=channel -number ] 

[ ,CIRCSW=(DATEX,n,m)] 

{, CTABLE=(label ,PCW,CIT,CDT)] 


,DESPACE= f U 
Y 
N 


[,DIALER=(slca-number, [eon][,prt])] 
[, 1D=stca-number] 





,INPUT= ( f name ] [,blanksI{, filename] ) 
YES 


{,LBL=l ine-buffer-length] 


,LOW= ( filename 
MAIN 


»MEDIUM= [ filename 
MAIN 


,HIGH= [ filename 
MAIN 


[,RDHLQSYES] 


,RECONECT= { QUEUES 
YES 


[,RETRY=( input-number , output -number) J 





continued 
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LABEL AOPERATIONA OPERAND 
»STATS= [ NO 
YES 
[, TIMEOUT=( input-time,output-time)] 
,TYPE= ( (line-speed]£,CRTSIC,FLDQ]£,FULLI 


[,NIDLEIC,SWCHIE,SYNC] |, f[ AUTO ]) }L,X21] ) 
UNAT 


,XLATE= ( | labeli,idi | , | labelo,ido |) 
NO NO 





Note: For clarity, the DEVICE= operand is presented first in the format and operands 
descriptions. 
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Table 2-12. Applicability of LINE Macro and Its Operands 


ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 
Dedicated 


ODI! Networks 


Global Networks 


TCI (IMS) 
STDMCP 

2 | CMCS (COBOL) 
STOMCP 
TCI (IMS) 
Public Data 
Networks 


x 


0 
ie) 
0 





“Shows macro applicability 
LEGEND: 
R = Required O = Optional - = Not applicable 
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Label 


line-name 


Is a1- to 4-character label that identifies this line. 


Operands 


DEVICE= 
Identifies the devices connected to this line and their mode of operation, if 
applicable. ICAM includes the appropriate remote device handler based on 
this specification. You may also specify a user-written remote device handler 
with this operand. Suboperands must be coded in the order shown; code a 
comma for any omitted. 


DEVICE= (BSC, [ line-buffer-length , | ASCII C, INTER}) 
{ 216 } | EBCDIC | 
TRANSCOD 
BSC 
Identifies a binary synchronous communications controlled device. 
Must be specified for: 


¢ IBM 2780 or 3780 terminals 

¢ 3741 data communications terminals 

¢ UDS 2000 emulating IBM 2780 or 3741 terminals 
¢ UNIX OSS emulating IBM 2780/3780 terminals 


line-buffer-length 
Specifies line buffer length in bytes. Calculate as follows: 


2m + mn for nontransparent mode 
4m + man for transparent mode 
where: 
m = number of records per block 
n = number of data characters per record 


If line-buffer-length is omitted, a default line buffer length of 216 is 
assumed. 


ASCII 
Indicates messages are in ASCII code. 
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EBCDIC 
Indicates messages are in EBCDIC code. The UDS 2000 
(emulating an IBM 2780/3741) uses EBCDIC code. 


TRANSCOD 
Indicates messages are in TRANSCODE code. Transcode is not 
valid for IBM 2780EM or 3780EM. 

INTER 
Specifies a message-oriented CPU-CPU BSC connection for IMS 
and TIP30 users only. This specialized remote device handler is 
designed for inquiry/response to data bases in another CPU (not 
file transfers). 


Line-buffer-length must exceed the largest output message or input 
block by 4 bytes. Each output message is sent as a message (ETX), 
while input continuation segments (ETB) are assembled into one 
message up to 32K bytes. , 


DICE is not supported and a leading DLE will abort an output 
message. Record separators are not supported or recognized. 


IMS/TIP30 control messages and BELs are not sent to another 
CPU; only data messages are sent. 


Normal ICAM batch mode requirements of one record per network 
buffer do not apply. 


On the TERM macro, follow the FEATURES=(IBSC...) parameters. 


DEVICE= DCT2EM, [ 84 
132 


DCT2EM 
Indicates that this line supports a System 80 emulating a DCT 
2000 data communications terminal. 


84 or 132 
Is the line buffer length in bytes. 
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DEVICE= DCT2000, [ 84 
132 


DCT2000 
Identifies a DCT 2000 data communications terminal. 


8&4 or 132 
Is the line buffer length in bytes. This specification must 
correspond to the print line length specified for this device in the 
FEATURES operand of the TERM macro. If 84 is specified (or 
defaulted) for line buffer length, 80 must be specified (or defaulted) 
for print line length; if 132 is specified for line buffer length, 128 
must be specified for print line length. 


DEVICE=(DCT475) 
Identifies a DCT 475 data communications terminal. 


DEVICE=(DCT50@, AUTO) 
Identifies one or more DCT 500 or DCT 524 data communications 
terminals operating in automatic mode. (In automatic mode, these 
terminals can be mixed on a line.) 


DEVICE=(DCT500,TTY) 
Identifies a DCT 500 or 524 terminal operating in teletypewriter mode. 


DEVICE=( INV3271) 
Identifies a 3271 emulator line to an IBM host (IBM 3270 emulator). 


DEVICE=(LWS) or DEVICE=(LWS,KA) 
Identifies a local workstation (UTS 20D/40D or SVT 1122) or a local 
workstation with Katakana support that is accessed through ICAM. 
Unless you specify translation table substitution, XLATE=(NO,NO) 
must be specified for local workstations with Katakana support. 


UTS 40D and SVT 1122 local workstations have dual-screen support 
through ICAM. System mode exists on screen 1 only, but data mode 
input is accepted on both screens. To take advantage of the dual-screen 
support, two TERM statements must be defined for the LINE. 
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DEVICE=(MAP5RDH) 
Specifies this line requires the MAPPER® 5 remote device handler to 
interface with a MAPPER 5 system. 


Note that when you specify DEVICE=(MAP5RDH): 


e Line buffer length (see LBL operand) is forced to a minimum of 700 
words 


e FEATURES operand on the TERM macro must be specified as 
FEATURES=(U200,1920...) 


DEVICE=(RDHAL ,RDHBIL,RDHCIC,RDHDJ) 
Includes one to four user-written remote device handlers in the ICAM 
symbiont. You must assemble your handlers prior to network 
generation, assign RDHA, RDHB, RDHC, or RDHD as its module name, 
and store it in the SG$OBJ library on the system resident volume. 


DEVICE=(RWS) 
Identifies a remote workstation. This workstation may be a Unisys 
Universal Terminal System (UTS 20/30/40, PC, SVT 1123/1124) as 
designated by the TERM macro. When you specify this operand, you 
must also specify DCA=YES and GAWAKE=YES in the CCA macro and 
a PGROUP macro for each polling group. 





DEVICE=(TTY,33), DeviceRtITY,59); or DEVICE=(TTY,37) 
Identifies a Teletype~ Model 33, 35, or 37 teletypewriter using ASCII 
code. 


Note: For the UTS 10 teletypewriter model single-station display 
terminal, specify DEVICE=(TTY). 


DEVICE=(TTYEM) 
Indicates that this line is emulating a full-duplex, uncontrolled, TTY- 
like device. Specify this parameter for an OS/3 to UNIX™ O/S 
connection through an asynchronous line. (The System 80 appears to 
the UNIX O/S as an asynchronous terminal.) When you specify this 
option, you must specify FEATURES=(TTYEM) on the TERM macro. 
You may specify only one TERM macro for each TTYEM line. 


MAPPER is a registered trademark of Unisys Corporation. 
Teletype is a registered trademark of Teletype Corporation. 
UNIX is a registered trademark of AT&T Information Systems. 
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Identifies one or more of the following Unisys terminals or terminal 
systems: 


e UNISCOPE 200 
© UDS 2000 operating similar to a UNISCOPE terminal 


¢ UTS 400 operating similar to a UNISCOPE terminal or UTS 400 
native mode 


e UTS 400 text editor 
¢ UTS 4000 Universal Terminal System 
¢ UTS 20/30/40, PC with STEP, SVT 1120/1123/1124 


e UNIX operating system using UNISCOPE emulation through the 
Programmable Communications Controller 


e B2X workstation with UNISCOPE emulator 


DEVICE=(UNISCOPE ,KA) 
& Identifies one or more UTS 400/4000 Universal Terminal System 
terminals that utilize Katakana/English keyboards. Applies only to 
terminals operating in native mode. 


DEVICE=(UTSX) 
Identifies a line for use with an X.21 circuit-switched PDN for 
connection to a UTS 20X terminal. 


DEVICE=( 1004) 
Identifies a 1004 card processor operating under control of an RMS1 


plugboard. 


DEVICE=( 1@04EM) 
Indicates that this line supports a System 80 emulating a 1004 card 
processor. 


DEVICE=(3271) 
Identifies one or more IBM 3270 terminal systems operating in the BSC 
polling/selecting mode. The IBM 3270 terminal system consists of a 
3271 control unit and a 3277 display station. It may optionally have a 
3284 printer or a 3286 printer. 
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DEVICE=(9200) 
Identifies a 9200 data processing system (using REM-1 protocol) 
emulating a 1004 card processor operating under control of an RMS1 
plugboard. 


DEVICE=(9300) 
Identifies a 9300 data processing system (using REM-1 protocol) 
emulating a 1004 card processor operating under control of an RMS1 
plugboard. 


CALL=phone-number . 
Is a numeric or alphanumeric telephone number used to dial a terminal. 
Must be specified for either automatic or operator dialing. 


In automatic dialing, a hyphen in the phone number causes a 1.1-second 
pause. This delay is necessary whenever a connection must be made before 
more dial characters are sent. For example, if you code CALL=6-444-4567 
for a tie line, the 6 initiates the first connection of the tie line, then a1.1 
second pause occurs before the next character is sent. After the 444 is sent, 
another pause occurs allowing that connection to be made before the 4567 is 
sent. The hyphens are not sent to the automatic calling unit. 


For automatic dialing, the maximum number of dialing digits and hyphens 
in the phone number is 48. For manual dialing, the maximum number is 11. 
If you specify more, the number is truncated at the console. For security 
purposes, you could specify a code word to the operator who would then dial 
the known number. 





Note: Do not specify the CALL operand if you specify unattended answering 
(UNAT). 


CHAN=channel -number ; 
Specifies the input/output microprocessor (IOMP) to which the single-line 
communications adapter (SLCA) is connected.” 


For System 80 models 3 through 6, this operand is optional. If specified, the 
only value permitted is CHAN=2. Up to eight SLCAs (ID=8 to ID=15) can be 
specified for these models. 


For System 80 models 8 through 20 with one IOMP, this operand is optional. 
If specified, the only value permitted is CHAN=13. Up to 14 SLCAs (ID=1 to 
ID=15) can be specified for the IOMP. 


For System 80 models 8 through 20 with two IOMPs, this operand is 
optional. The default is CHAN=13. If specified, you must also specify the ID 
operand. The only values permitted are CHAN=13 and CHAN=15. Up to14 
SLCAs (ID=1 to ID=15) can be specified for each IOMP. 
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CIRCSW=(DATEX,n,m) 
Specifies a logical connection of one or more physical links (lines) to a 
DATEX-L circuit-switched public data network. 


n 
Is the number of physical lines connected to the network. 


m 
Is the number of lines dedicated to incoming calls. 


Notes: 


1. When specifying the CIRCSW parameter, the keyword parameter 
DIALER= must also be specified. 


2. When specifying this parameter, the value specified by the ID= keyword 
represents the first physical line in a group of circuit-switched lines. The 
remaining lines in the group must be on succeeding ascending ports. 
This applies also to the DIALER= keyword: 

LINE CIRCSW2=...,3,0), [D=4, DIALER=(10) 


For example, the following is a typical hardware configuration: 


data port 4 

data port 5 
c data port 6 
M dial port 1@ for data port 4 
M dial port 11 for data port 5 


dial port 12 for data port 6 


CTABLE=( Label ,PCW,CIT,CDT) 
Permits the user to modify any or all of the loadable SLCA-1 or SLCA-2 
parameters -- port control word (PCW), character interpret table (CIT), and 
character detect table (CDT) -- on a per line basis. 


label 
Name of a user-supplied set of assembler DC statements that specify 
any or all of the loadable SLCA tables. The first word must be a full- 
word PCW or a full-word of zeros. The second statement is 16 half- 
words of the CIT or 16 half-words of zero. The third statement is a 256- 
byte CDT. 


PCW 
Specifies the new port control word. If itis not to be changed, insert a 


full-word of zeros and leave the positional parameter null. If only the 
port control word is being changed, no other statements are required. 
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CIT 
Specifies a 16 half-word character interpret table. If it is not to be 
changed, insert 16 half-words of zero and leave the positional parameter 
null. 


CDT 
Specifies a 256-byte character detect table. If it is not to be changed, 
leave the positional parameter null. 


For example, to change a character detect table, specify the following: 
CTABLE=(MYDEF,, ,CDT) 
Prior to the ENDCCA statement, the following would appear: 


MYDEF Dc OF '@! no pcw 
DC 16H'@! no cit 
DC XL32'1st 32 char! ist 32 characters of cdt 
DC XL32'next 32 char! 2nd 32 characters of cdt 
DC XL32'next 32 char! 3rd 32 characters of cdt 
DC XL32'next 32 char' 4th 32 characters of cdt 
DC XL32'next 32 char' 5th 32 characters of cdt 
DC XL32'next 32 char' 6th 32 characters of cdt 
DC XL32'next 32 char' 7th 32 characters-of cdt 
DC XL32'next 32 char' 8th 32 characters of cdt 





DESPACE= 
Specifies the action to be taken by ICAM or interactive services for loading 
the destructive space specification of the control page. This parameter 
applies only to remote workstations, UNISCOPE terminals, and 
UNISCOPE-like devices attached to a DCP. 


DESPACE=) 
The destructive space parameter is not to be altered (that is, it remains 
set as previously specified in the control page). This is the default 
value. 


DESPACE=Y 
The destructive space parameter is set each time ICAM or interactive 
services loads the control page. 


DESPACE=N 
The nondestructive space parameter is set each time ICAM or 
interactive services loads the control page. 


Note: The ICAM destructive space definition is restricted for use by terminals 
located on a cluster controller, which are not loaded with the correct ICAM 
gen specification for DESPACE=U/Y/N. To obtain the desired destructive 
space setting, you must manually change the control page specification or 
use the interactive services SCREEN command. & 
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DIALER=(slca-number , [eon], prt) 


Identifies the location of an automatic dialer. Specify this operand only for 
lines with automatic dialing by the computer. Figure 2-1 illustrates the way 
ports are defined on SLCAs and shows how to specify this operand. 


slca-number 
Specifies the decimal SLCA where the dialer is located. Specify an 
SLCA number that is not used by any LINE or VLINE macro in this 
network definition. 


eon 
Specifies an optional end-of-number character required by some 
automatic calling units. Refer to the operating instructions for your 
calling unit to see if it requires one. 


Each single-line communications adapter can accept up to three 
automatic calling units. Specify a decimal number 0, 1, or 2 that 
identifies the port on the SLCA where the calling unit is installed. If no 
value is specified, 1 is the default. 


Note: Do not specify DIALER if you specify unattended answering (UNAT). 


1D=slca-number 


Specifies the address on the input output micro-processor (IOMP) channel 
where the single-line communications adapter (SLCA) this line uses is 
connected. The SLCA number is specified in decimal. This SLCA number 
must match the SLCA number specified in the associated CACH statement. 


This operand is required for private lines and switched lines with automatic 
dialing or unattended answering. (For lines with automatic dialing, you 
must specify an ID and DIALER operand for the automatic calling unit used. 
See Figure 2-1.) 


For System 80 models 3 through 6, you can specify up to eight SLCA 
numbers (ID=8 to ID=15). 


For System 80 models 8 through 20, you can specify up to 14 SLCA numbers 
(ID=1 to ID=15) for each IOMP channel. When you specify the ID operand 
and do not specify the CHAN operand, CHAN defaults to 13. 


Whenever you do not specify an ID operand, ICAM assigns an SLCA number 
based on the requirements specified in the TYPE operand. 
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. SYSTEM 80 


AUTOMATIC CALLING UNIT O 
(FOR PHYSICAL LINE 10) 
AUTOMATIC CALLING UNIT 1 ca ee SLCA 8 
DIALER 
(FOR PHYSICAL LINE 11) ADAPTER F3794 ( ) 


AUTOMATIC CALLING UNIT 2 
(FOR PHYSICAL LINE 12) 


AUTOMATIC CALLING UNIT O 
(FOR PHYSICAL LINE 13) 





SINGLE LINE 
COMMUNICATIONS SLCA 9 
ADAPTER F3794 (DIALER) 





SINGLE LINE LOGICAL 
| mooem | COMMUNICATIONS LINE 


ADAPTER 10 (DATA) LNE1 





LNE1 LINE DEVICE =(UNISCOPE), TYPE=(2400, SWCH, SYNC, AUTO), ID= 10. DIALER=(8,,0), CALL = 1234567 


SINGLE LINE LOGICAL 
| MoveM | COMMUNICATIONS LINE 
ADAPTER 11 (DATA) LNE2 





LNE2 LINE DEVICE =(UNISCOPE), TYPE =(2400, SWCH, SYNC, AUTO), ID=11, DIALER=(8,,1), CALL = 1234568 


SINGLE LINE LOGICAL 
| MODEM | COMMUNICATIONS LINE - 
ADAPTER 12 (DATA) LNE3 





LNE3 LINE DEVICE (UNISCOPE), TYPE (2400, SWCH, SYNC. AUTO). ID 12, DIALER (8.2), CALL 1234569 


SINGLE LINE LOGICAL 
}_ MODEM | COMMUNICATIONS LINE 


ADAPTER 13 (DATA) LNE4 





LNE4 LINE DEVICE (UNISCOPE), TYPE (2400, SWCH. SYNC, AUTO), ID 13, DIALER (9,,0), CALL 1244567 


SINGLE LINE LOGICAL 
| movem | COMMUNICA TIONS LINE 


ADAPTER 14 (DATA) LNES 





LINES LINE DEVICE (UNISCOPE), TYPE (2400), 1D 14 


SINGLE LINE LOGICAL 
[mone | COMMUNICATIONS LINE 
ADAPTER 15 (DATA) LNE6 





LNE6 LINE DEVICE =(UNISCOPE), TYPE =(2400), ID= 15 


Figure 2-1. How to Specify SLCA Ports Using Automatic Dialing and Leased Lines 
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INPUT= { name ) [,blanks1[, filename] 
YES 


Establishes a destination for input messages for all of the terminals on this 
line unless overridden by an INPUT operand in a TERM macro. 


Note: You must specify this operand for all terminals on this line - either here or 
in a TERM macro. 


name 
Is a 1- to 4-character name that matches the label field of a LOCAP, 
PRCS, MPPS, or TERM macro. This is the name you address on 
GETCP calls to a process file or to a LOCAP file to retrieve input 
messages from a terminal. Depending on the name you specify, input 
messages from all terminals on this line are directed to one of the 
following: 


e the low priority queue of a user program defined by the label of a 
LOCAP macro (global networks only). 


e the low priority queue of a process file, defined by the label of a 
PRCS macro. 


¢ the low priority queue of a terminal, defined by the label of a 
TERM macro (this causes message switching because a message, 
@ input from a terminal on this line, is immediately placed on the 
output queue of another terminal). 


¢ adestination determined by an MPPS routine, with the name of 
the routine defined by the label of an MPPS macro. An MPPS 
routine is the only input destination you can specify if you use the 
transaction control interface. 


YES 
Automatically creates an input message queue for each terminal on this 
line. If you also include the filename suboperand, input messages are 
held in a disk file until your program accesses them. If you omit 
filename, main storage input message queues are established. 


Your program accesses a message placed on one of these queues by 
issuing a GETCP macro and, in the related DTFCP, specifying the label 
of the appropriate TERM macro. You need not specify a priority. 


This suboperand is not supported for the transaction control interface. 


blanks 
Is a decimal value from 1 to 255 indicating the number of bytes you 
want reserved in front of each input message for message processing 
routine (MPPS) or your program’s insertion of data. 
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filename 
Is a 1- to 7-character name of a disk file where input messages from 
terminals on this line are stored until your program accesses them. The 
filename must match the label of a DISCFILE macro. Include this 
suboperand only if you also specify YES. 


LBL=l ine-buffer-length 
Is a decimal number that specifies line buffer length in words (one word 
equals four bytes). Do not include this operand for 1004, 9200/9300, 
DCT2000, or NTR. For UNISCOPE-type lines, the maximum value is 1024 
words. For IBM 3270, this keyword is ignored and a 65-word line buffer is 
generated. 


For local workstation terminals, line buffer length must be at least the size 
of your largest message (including format information). If you do not specify 
this operand, the default value is 600. 


For a local workstation emulating an IBM 3270 terminal, specify 1200 to 
prevent truncation of large messages from the IBM host. 


For dual-screen local workstations (UTS 40D and SVT 1122), two line 

buffers of equal size are generated. This allows data mode input and output 

to be processed on both screens. For example, if you specify LBL=900, two 

900-word buffers are generated. @ 


For remote workstations, DEVICE=(RWS), omit the LBL operand. A default 
value of 4 words is generated. Be sure to specify the UDUCT and LINKPAK 
parameters on the BUFFERS macro. 


For a line connected to a MAPPER 5 system (DEVICE=(MAP5RDH)), 
specify at least 700 words. If you do not specify this operand or you specify a 
value less than 700 words, it defaults to 700 words. 


For full-duplex, uncontrolled TTY emulation (you specified 
DEVICE=(TTYEM)), the default value is 64 words. 


For all other devices, if you omit LBL, the following default values are 
generated, based on your line-speed specification in the TYPE parameter: 


Line Speed Default Value 
(maximum baud rate) (words) 

Up to 2400 20 

From 2401 to 4800 40 

From 4801 to 9600 80 

From 9601 to 19,200 160 
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LOW, MEDIUM, HIGH 
Specifies the priority for the output queue for this line. 


LOW=f i Lename 
Creates a low priority output queue for this line on a disk file you name 
in a DISCFILE macro. 


LOW=MAIN 
Creates a low priority output queue for this line in main storage. 


MEDIUM=f i Lename 


Creates a medium priority output queue for this line on a disk file you 
name in a DISCFILE macro. 


MEDIUM=MAIN 
Creates a medium priority output queue for this line in main storage. 


HIGH=filename 


Creates a high priority output queue for this line on a disk file you name 
in a DISCFILE macro. 


HIGH=MAIN 
Creates a high priority output queue for this line in main storage. 


@ Note: If you omit the LOW, MEDIUM, and HIGH operands, a low priority 
output queue is created in main storage for this line (except when 
specifying global networks). If you specify any LOW, MEDIUM, or HIGH 
operand in a TERM macro, it overrides this macro for that terminal only, 
and a terminal output queue is created. Line queuing must not be specified 
for global networks. 


RDHLQ=YES 
Allows a message to be sent to a terminal while a previous message sent to 
another terminal on this multistation line is being transferred to an 
auxiliary device. This operand is applicable to user-written remote device 
handlers only. When it is included, terminal queuing must be specified for 
each terminal on this line. 
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RECONECT= 
Provides immediate logical reconnection of unattended (call-in) lines when 
the original caller disconnects. ICAM does not notify your program or the 
operator console of the reconnection; however, a LINE DOWN message is 
sent to the console if the reconnection fails. This keyword is valid only ina 
dedicated network. 


Note: Do not specify the RECONECT operand for local workstations 
(DEVICE=(LWS)). 


RECONECT=QUEUES 
All output queues, including INTERCEPT, are cleared before 


reconnection. 


RECONECT=YES 
Output queues remain intact at reconnection; next caller receives 


queued output. 


RETRY=( input -number , output -number ) 
Number of retries before ICAM marks a terminal down and polls it ata 
slower rate (slow-polling). Input-number and output-number values range 
from 1 to 255. 


input -number 
Number of times the remote device handler resends a poll because of an 
error (such as parity errors or time-out). 


output -number 
Number of times the remote device handler tries to send a particular 


output message. 


For binary synchronous communication (BSC) devices, input retries apply 
only to the host bidding for the line. All other retries are considered output 
retries. For DCT 2000, both input and output retries are determined by the 
output-number value. 


The RETRY operand does not apply to local workstation terminals, DCT 
475, DCT 500/524, UTS 10, or Teletype. 
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The following RETRY defaults are generated if omitted: 


STATS= [ NO 


Device Type Input Output 
BSC 6 4 
UNISCOPE/DCT 1000 6 4 
DCT 2000 - 4 
1004/9200/9300 6 4 
IBM 3270 4 6 
IBM 3270 Emulator 6 4 
RWS 6 4 
YES 


Specifies whether terminal statistics are accumulated for this line. If you 
specify STATS=YES, terminal statistics are accumulated for each terminal 
on this line. The TN#TSTAT field of each terminal control table (covered by 
the TN#TCT dummy control section) gives the relative address of the 
statistics area for that terminal. The following is the format of the 3-word 
statistics area: 


BYTE 


Number of messages received Number of input 
retransmission requests 


Number of messages transmitted Number of output 
retransmission requests 


Number of polls sent Number of no-traffic 
responses 





For a local workstation, the number of polls sent is the number of read 
instructions that were issued. The number of no-traffic responses is the 
number of times a read instruction was canceled because an output message 
was sent before input data was received. 
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TIMEOUT=( input- time, output- time) 
Time-out values, in seconds, for input and output messages. Input-time and 
output-time range from 1 to 255. If time-out occurs, ICAM retries the 
number of times specified in the RETRY operand. No retries are made for 
DCT 500/524, UTS 10, or Teletype. This operand does not apply to local 
workstation terminals. 


input-time 
The number of seconds in which terminals on this line must respond to 
polls or fill one of the line’s pair of line buffers. 


For binary synchronous communications (BSC) controlled devices, the 
input-time value is used when input text is expected or during receipt of 
input text. For DCT 500/524 and Teletype, this value applies to input 
text after the first input text character is received. 


output - time 
The number of seconds in which terminals on this line must 
acknowledge receipt of a message sent by the host processor. This 
operand does not apply to local workstation terminals. 


If timeout values are omitted for other devices, the following default values 
are generated: 





Device Type Input Output 
BSC 3 20 
UNISCOPE/DCT 1000/ 

UTS 400/UTS 4000 3 20 
DCT 500/524/TTY/UTS 10 512 20 
DCT 2000 9 20 
1004/9200/9300 4 20 
IBM 3270 3 20 
IBM 3270 Emulator 300 3 
RWS 3 20 


Note: The TIMEOUT operand is ignored by the 3270 emulator and should 
not be specified. 
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UNAT 


TYPE= een enero { AUTO } ee 


Specifies the characteristics of this line. Table 2-13 lists the specifications 
associated with line characteristics, plus other required operands. Line- 
speed, if required, must be the first TYPE suboperand specified. Code a 
comma if you omit it. The other suboperands may be coded in any order. 
The TYPE operand is not required for local workstations. 


line- 


speed 

Specifies the rate in bits-per-second at which data is exchanged between 
terminals connected to this line and ICAM. The speed you specify is 
used only by the ICAM software to establish an internal buffer; 
therefore, it need not match the line speed of your line exactly. 
However, the value you specify must be one of those provided in Table 
2-14. In general, the larger the value you specify, the better your 
performance will be for that line; however, additional main storage 
would be required. Table 2-15 indicates maximum line speeds in bits 
per second (bps) for ICAM-supported terminals. 


Note: ICAM does not support switched-line speeds greater than 9600 bps. 


CRTS 


FLDQ 


FULL 


Indicates the request-to-send signal is cleared in output/output message 
sequences. This inhibits the sync character from being sent. 


Specifies 2-way simultaneous queuing. Input and output messages are 
queued to and from a 2-way simultaneous communications line. For 
standard (ICAM-supplied) remote device handlers, this feature is 
available only with NTR and intelligent line adapter (ILA) lines; it can 
also be used with user-written remote device handlers. If you specify 
FLDQ, you must also specify FULL. 


Indicates this dedicated line is capable of 2-way simultaneous 
transmission (full-duplex operation). The ICAM remote device handlers 
do not operate terminals in this mode (except as described under FLDQ) 
but can take advantage of this line characteristic to decrease 
turnaround time. Omit this option for 2-way alternate transmission 
(half-duplex operation). When this option is specified, the ID keyword 


must also be specified. 


Note: Ifan ICAM remote device handler uses 2-way-alternate protocol, the 


line must be defined as 2-way-alternate also. All ICAM remote device 
handlers use this protocol except NTR, UDLC, ABM, and level 2 X.25 
public data networks. If 2-way simultaneous protocol is used, it must 
be specified in the ICAM generation (LINE and CACH). Two-way 
simultaneous modems and lines may be used with 2-way-alternate 
protocol, if required. 
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Table 2-13. Line Characteristics and TYPE Specifications 


Line Characteristic 


Baud rate 


Automatic dialing 


Operator dialing 

Automatic answering 

(unattended answering) 

Dedicated line 

Two-way simultaneous transmission 
(full -duplex) 


Two-way simultaneous transmission 
for NTR and ILA 


Two-way simultaneous transmission 
for TTYEM 


Two-way alternate transmission 
Chal f-duplex) 


Synchronous transmission 


Asynchronous transmission 


Request-to-send signal 
No Line turnaround ** 


Automatic Line turnaround 
(for hal f-duplex synchronous line) 


Notes: 


TYPE Specifications 


fee 
AUTO, SWCH * 


SWCH 
The ID operand is optional. 


SWCH, UNAT 


Code a comma to override 
SWCH default 


FULL 
FULL, FLDQ 


FULL, FLDQ 





Default condition 


SYNC 


Default condition for teletypewriters 
For other devices, code a comma to 
override SYNC default. 


CRTS 
NIDLE 


Default condition 








* DATEX-L always requires the specification of both AUTO and SWCH. 
** Applies to synchronous, 2-way alternate transmission on UNISCOPE/UTS 4@@/UTS 4000 


terminals only. 











Other Operands 


CALL= 
DIALER= 
ID= 
CALL= 


ID= 


ID= 
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Table 2-14. Line-Speed Values 


Asynchronous Line Speeds Synchronous Line Speeds 





Table 2-15. Maximum Line Speed of ICAM-Supported Terminals 


Terminal 


UNISCOPE 188 and 20@ Display Terminals 


UTS 20/30/48 Single Station Terminals 


UTS 400 Universal Terminal System 


UTS 4020/4040 Cluster Controtlers 


SVT 1120/1123/1124 


PC with STEP 


B2X workstation with UNISCOPE emulator 


DCT 475 Data Communications Terminal 


DCT 500/524 Data Communications Terminals 


DCT 200@ Data Communications Terminal 


UDS 2008 Universal Distributed System 


Baud Rate (bps) 





9620 


9608 


19,200 


19,200 


19,200 


9,600 


110 


308 


2408 


9608 


continued 
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Table 2-15. Maximum Line Speed of ICAM-Supported Terminals (cont,) 





Terminal Baud Rate (bps) 
Teletype Models 33, 35 110 
Teletype Model 37 150 

UTS 18 Universal Terminal System 

Single Station in Teletypewriter Mode 9600 
18M 2788 Data Communications Terminal 4880 
1BM 378@ Data Communications Terminal 4800 
IBM 3278 Data Communications Terminal System 7200 
1BM 3741 Data Communications Terminal 9600 
UNIX System (500/20, 30, 4@, 50, 60, 80, 90) 

IBM 2780 or 3788 emulation 4800 
UNIX System using PCC for UNISCOPE emulation 19,200 
1004/1085 Card Processor 9600 
9208/9388 Data Processing System 56K 
MAPPER 5 19,200 
UNIX System connected to OS/3 via asynchronous Line 4808 





NIDLE 
No automatic line turnaround is desired. Automatic line turnaround 
prepares the line for output immediately after completion of input. This 
applies only to a synchronous line with 2-way alternate transmission 
and UNISCOPE and UTS 400 terminals. 


SWCH 
Specifies this line is switched (it must be dialed automatically by the 
computer or manually by the operator). This is the default. 


Specify a nonswitched (dedicated) line by specifying a comma anywhere 
in the TYPE operand and not specifying SWCH. For example: 


TYPE=(110,),1D=4 
Specifies a dedicated asynchronous line with a line speed of 
110, using port 4. 
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LINE 


TYPE=(240, SYNC) 
Specifies a dedicated synchronous line. Notice the absence of 
the SWCH suboperand and the presence of a comma and the 
SYNC suboperand. 
SYNC 


Specifies this line’s hardware is set for synchronous transmission of 
data. 


If you omit the SYNC suboperand, and you have coded a comma 
anywhere in this operand, asynchronous transmission is assumed. For 
example: 


TYPE=(2400,), 1D=6 
Specifies a dedicated (nonswitched) asynchronous line with a 
line speed of 2400 baud, using port 6. Notice that a comma 
was coded in the TYPE operand, and SWCH and SYNC were 
not specified. The comma causes a default to dedicated and 
asynchronous. 


TYPE=(2400, SWCH) 
Specifies a switched asynchronous line with a line speed of 
2400 baud. Notice that a comma was coded along with the 
SWCH suboperand. This indicates that asynchronous 
transmission is required. 


TYPE=(2400, SWCH, SYNC) 
Specifies a switched synchronous line. 


AUTO 


Indicates this line is equipped for automatic dialing. Applies only to 
switched lines. 


UNAT 
Indicates the computer automatically answers incoming calls 
(unattended answering) from the terminals on this line via the switched 
telephone network without operator intervention. Applies only to 
switched lines. Not available if FEATURES=BASIC is specified in the 
CCA macro. 


x21 
Indicates this line is used with an X.21 circuit-switched PDN for 
connection to a UTS 20X terminal. When this option is specified, 
SWCH must also be specified. 
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YES YES 
Determines what translation tables, if any, are used for I/O on this line. If 
omitted, standard ICAM translation tables are used for both input and 
output. This operand is overridden for a specific terminal if an XLATE 
operand is included for that terminal in the TERM macro. (For a discussion 
of how to generate translation tables, see 4.5.) For IBM 3270 terminal 
systems and/or local workstations with Katakana support, specify 
XLATE=(NO,NO). See DEVICE=(LWS,KA). 


XLATE= ( | labeli,idi | , | labelo,ido ] ) 
NO NO 


label i 
Is the name of a user-supplied input translation table. It must 
correspond to the label of a translation table generated in this network 
definition. You may name the same input translation table in any 
number of LINE and TERM macros. 


idi 
Is a decimal number, 1 to 240, further identifying the translation table 
named in the /abeli suboperand. The idi numbers provide an index to 
the addresses of input translation tables. You should use a different 
number for each labeli name; if you use the same number with more 
than one labeli name, only the last labeli name is used. 





NO 
Input from devices on this line is not translated. 


Standard ICAM translation table is used for input from devices on this 
line. 


labelo 
Same as labeli but specifies a user-supplied output translation table. 


Same as idi but for the output translation table named in the labelo 
operand. 


NO 
Output to devices on this line is not translated. 


Standard ICAM translation table is used for output to devices on this 
line. 


Note: The idi and ido suboperands index separate input and output tables; that 
is, you can have up to 240 input tables and 240 output tables and you can 
duplicate idi and ido values. You should assign consecutive numbers, 
starting with 1, to save main storage space. 
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Example 


The following example shows LINE macros. 





1 72 

LNE1 LINE CALL=6469030, X 
DEVICE=(UNISCOPE), x 
TYPE=(2000,UNAT,SWCH,SYNC), x 
ID=4 ° 

LNE2 LINE CALL=1759030, xX 
DEVICE=(TTY,33), x 


TYPE=(110, SWCH) 


LNE3 LINE DEVICE=( 1004), xX 
TYPE=(2400), xX 
ID=6 

LNES LINE DEVICE=(LWS), x 


INPUT=(PRF3) 
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2.15. How to Create a LOCAP File for Global 
Networks (LOCAP) 


This macro creates a local (in this computer) or remote (in a different computer) 
LOCAP file for programs that use a global network. This includes a public data 
network environment. 


A LOCAP file acts as an intermediary for your program, i.e., messages destined for 
your program are queued to this LOCAP file by ICAM until your program issues a 
GETCP request for them}. In order to access this LOCAP file (i.e., to be able to issue 
GETCPs to it), your program must issue an NATTACH interface macro with the 
APPS operand specified the same as the label of this macro. 


Table 2-16 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 





Format 
LABEL AOPERATIONA OPERAND 
LOCAP-name TYPE=([ STOMCP ]) 
TCI | 
[ ,DUSTERR=INLINE} 


C, TAS=(YES,OFF)] 
C, JOBINIT=(LOAD, REPORT) ] 
[, JOBNAME=jobname] 


Ha 


sMEDIUM=[ MAIN 
filename 


,HIGH=( MAIN 
filename 


[ ,MODE=SYSTEM] 


,REMOTE=[ node 
subname , PDN : 





1 Of course, a LOCAP file is not the only way your program can receive messages; you can specify that input 
messages are to be queued to input queues (INPUT=YES), or to a process file, e.g., INPUT=PRF1, and your 
program would issue GETCPs against these queues. 
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Table 2-16. Applicability of LOCAP Macro and Its Operands 


Macro: 
LOCAP . 


Operand 
Name 


*LOCAP 


label 


DUS 


TERR = 


HIGH = 


IAS= 


JOBINIT = 


JOBNAME= 


LOW = 


MEDIUM= 


MODE= 


REMOTE = 


TYPE= 





1CAM Network Type and Kind of Program Supported 


Ea 


Ea 


Global Networks 
Networks 


TCI (IMS) 


*Shows macro applicability 
LEGEND: 
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R= 


Required 


O= 


Optional 


STOMCP 

STDMCP 

TCI (IMS) 
COBOL 


2 y 
8 

a§ 
23 
ao 
3 

Le 


CMCS (COBOL) 


1 

1 
Pe] 
a 
Ps) 
Ps) 


= = Oo = ce 3 oS a: 
-|-]o]o]-]-]o]o 
- |-]}]-]-]- [rR] Rio 
= = 7 = Oo = a = 
= = - 2 Oo = = = 
-]|-]o]fo]-]-ftolo 
-|-]1olo]-]-]olfo 
-]|-]-]-]- Joflolo 
-|-}-]-]- [- ][o]o 


= Not applicable 





LOCAP 
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eS 


Label 


LOCAP- name 
Identifies a LOCAP file. It is the name your program must specify in the 
APPS operand of an NATTACH interface macro when it requests 
attachment to this global network. Other communications user programs 
direct messages to this LOCAP file by means of this label. If you are 
running Telcon, this name must be paired with the Telcon configuration 
XEU statement or the DESTSSU parameter of the XEU statement. 


Operands 


TYPE= 
Specifies the type of interface. 


TYPE= B) 
Specifies the standard interface is used to communicate with this 
LOCAP file. 


TYPE=(DMI) 
Specifies the demand mode interface is used to communicate with this 
LOCAP file. Required if ICAM supports interactive services to allow 
terminals to be used as workstations or remote workstations, or for 
distributed data processing users. 


TYPE=(TCI) 
Specifies the transaction control interface for the information 
management system (IMS). 


DUSTERR=INLINE 
Specifies that, if an error occurs during DUST macro processing, all returns 
are inline. If you don’t specify DUSTERR=INLINE and an error occurs 
during DUST macro processing, ICAM returns control at the NETREQ 
ERRET= address you specify. , 


Note: The DUSTERR=INLINE specification is correct only when your 
program is coded to match the operand you specify. 


IAS=(YES, OFF) 


Specifies that interactive services is required (YES) and that DICE is not 
required (OFF). This operand is required when TYPE=(DM)I) is specified. 
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JOBINIT= 


Controls the scheduling of a COBOL communications program when initial 
input is received, and the reporting of same by means of a datagram. 


JOBINI T=LOAD 
Indicates that your COBOL program is automatically loaded and 
executed when the initial message is received. 


JOBINIT=REPORT 
Indicates that your COBOL program receives a report of the initial 
message. 


For details on how to use the JOBINIT operand, see the ICAM COBOL 
message control system (CMCS) utility in the JCAM Utilities Programming 
Guide (UP-9748). Also see the PRIMARY operand in the SESSION macro. 


JOBNAME=jobname 


LOW, 
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Is the 1- to 8-character name specified in the job control JOB statement that 
identifies the jobstream that executes your COBOL program. If you omit 
this operand, the label of this LOCAP macro is used. 


MEDIUM, HIGH 

Generates up to three input queues for messages destined for this LOCAP 
file. It is necessary to have at least one of these queues if you are going to 
use direct communications between your programs in a local or 
multicomputer global network or if any terminals specify this LOCAP file in 
the INPUT operand of the TERM macro. 


LOW=MAIN 
Creates a main storage input queue with low priority. 


LOW=f i lename 
Specifies a 1- to 7-character name of a disk file for low priority messages 
you created by means of a DISCFILE macro. 


MEDIUM=MAIN 
Creates a main storage input queue with medium priority. 


MEDIUM=f il ename 
Specifies a 1- to 7-character name of a disk file for medium priority 
messages you created by means of a DISCFILE macro. 


HIGH=MAIN 
Creates a main storage queue with high priority. 


HIGH=f i Lename 


Specifies a 1- to 7-character name of a disk file for high priority 
messages you created by means of a DISCFILE macro. 
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MODE=SYSTEM 
Specifies that a remote workstation in system mode is to use this LOCAP file 
for entry to interactive services. Only one LOCAP of this type is permitted 
in a network containing remote workstations, and TYPE=(DMI) must be 
specified. 


REMOTE=(node) 
In a multinode network, specifies the 1- to 4-character name of the 
destination node in which the remote program resides. This name must be 
the same that is specified for the REMOTE keyword of the LPORT macro. 
This LOCAP statement must follow the VLINE and LPORT statements with 
which these LOCAPs are associated. 


REMOTE=(subname , PDN) 
Defines a LOCAP file in a packet-switched public data network (PDN) 
environment that physically exists in a remote node. 


subname 
Specifies the symbolic name of the SUB macro in a packet-switched 
PDN that defines the remote subscriber. 


PDN 
Specifies a packet-switched public data network. 
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2.16. How to Create Remote Session Entry Tables 
(LPORT) 


This macro defines and creates a remote session entry table for each DCA logical port. 
The LPORT macro defines a logical path between DCA transport service users. (For 
example, between HOSTA and DCPA, or between HOSTB and HOSTC.) This macro is 
used by the TSTN interface. Each LPORT macro corresponds to an equivalent 
macro/statement in a remote configuration indicated via the PORT number. 


For UDLC/NRM networks, the LPORT macros must follow the corresponding 
STATION macro. 


Table 2-17 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 

LABEL AOPERATIONA OPERAND 
LINE=name, 
REMOTE=name, 
PORT=nnnn, 


EU 1=name 
{,£U2=name} 


,USERTP=[ DMI 
Tel 
StGHCe 


[,CATP= €] 





/PRI= 


Z2eWN = 
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Table 2-17. Applicability of LPORT Macro and Its Operands 


yoo ICAM Network } TEAM Network Type and Kind of Program Supported and Kind of Program Supported 


Operand ae 
Name 
ae a 
peated Global Networks 
Networks 


“LPORT 









Public Data 
Networks 










TCt (IMS) 
STDMCP 
STDMCP 
TCI (IMS) 
COBOL 
OCA 





CMCS Oru 






\ 
I 

| 

1 

' 

| 

t 
oO 
=] 

| 







CATP= 








EU1= 







EU2= 






LINE = 







PORT = 


PRI= 








REMOTE = 


USERTP= 





“Shows macro applicability 


LEGEND: 
R = Required PS = Packet-switched 
O = Optional CS!= Circuit-switched 


- = Not applicable 


Operands 


LINE=name 
Is the 1- to 4-character label from the DCPCHNL or VLINE macro. The 
name must begin with an alphabetic character. 
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LPORT 


REMOTE=name 
Is the 1- to 4-character name of the destination node. This name is a logical 
identifier of the remote node and must match the remote name used in 
remote LOCAP and TERM macros. 


PORT=nnnn 
Is the 4-digit port number in the range of 1 to 4096. 


EU 1=name 


Is the label of the TERM, PRCS, or LOCAP macro defining the local end 
user, 


EU2=name 
Is the label of the LOCAP, PRCS, or TERM macro defining the remote end 
user in another computer. This name must not be supplied for a program to 
Telcon terminal session. 


TCl 

STOMCE 
Indicates that the session operates through the demand mode interface 
(DMD), transaction control interface (TCD, or standard interface for DCA 
global networks (STDMCP). Specify STDMCP for circuit-switched public 
data networks. ICAM references the user type for outbound session opens 
and terminal spooling. 





mm DMI 


CATP= 
Defines the class of recovery procedure implemented by DCA DTP protocol. 


CATP=C 
Indicates use of dynamic sessions with provision for error recovery and 
assurance units for STDMCP and TCI users when output delivery 
notification is requested. 


PRI=n 
Indicates priority from 1 to 4. The default is 4. The highest priority is 1. 


Note: Because Telcon maintains a balance of the sessions across these 
logical paths, there should be no more than 20 active sessions per 
LPORT macro. For example, if 100 sessions are active between 
HOSTA and DCPA, at least 5 LPORT macros should be generated. 
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2.17. How to Define a Public Data Network (PDN) 


This macro specifies the name and attributes of the public data network to which you 
have subscribed. This macro must not be specified for DATEX-L public data network. 
(For DATEX-L, see 3.6.3.) The PDN macro must appear once in an ICAM global 

network definition after you have declared all of the macros for local communications. 


Table 2-18 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
CARRIER=[ DATAPAC 
DATEX 
DDX 
IBERPAC 
NORDIC 


PSs 
TRANSPAC 


cate 
aa 


C,PKTSIZ=size] 


7 TYPE={ CIRCUIT 
PACKET 


symbol 
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Table 2-18. Applicability of PDN Macros and Its Operands 


Hei ICAM Network Type and Kind of Program Supported 


Operand Di 
Name ‘iD 
Interface 
: Global Networks 


irect 
ata 
DDI 
NTR 
RBP 
RPG 
DES 










OM! 
OCA 
Public Data 


TCI (IMS) 
STDMCP 
Networks 







STDMCP 
TCI (iMS) 
COBOL 





za 
° 
4) 
° 
< 
” 
o 
2 
oO 


pd 







“PDN 


label 


CARRIER= 














DATAPAC 
DATEX 
DDX 
IBERPAC 
NORDIC 
PSS 
TRANSPAC 
L3MODE= 
MXCALL= 
PKTSIZ= 


TYPE= 





“Shows macro applicability t Not applicable to the DATEX-L public data network. 
LEGEND: 

R = Required CS = Circuit-switched 

oO = Optional PS = Packet-switched 


- = Not applicable 
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Label 





symbol 
Is a required 1- to 4-character label used to reference this macro. 


Operands 


CARRIER= 
Specifies the name of the public data network common carrier you are using. 
All networks are packet-switched except NORDIC. 


CARRIER=DATAPAC 
Specifies the Canadian DATAPAC public data network. 


CARRIER=DATEX 
Specifies the German DATEX-P public data network. 


CARRIER=DDX 
Specifies the Japanese DDX public data network. 


CARRIER=IBERPAC 
Specifies the Spanish public data network. 


CARRIER=NORDIC 
Specifies the Danish, Finnish, Norwegian, and Swedish NORDIC 
circuit-switched public data network. 


CARRIER=PSS 
Specifies the United Kingdom’s PSS public data network. 


CARRIER=TRANSPAC ; 
Specifies the French TRANSPAC public data network. 


L3MOD=[ 128 
8 


This operand applies only to packet-switching public data networks and 
specifies the modulus of the level 3 send and receive window. That is, it is 
the number of packets that may be sent or received in one level 3 window. 


2 
This operand applies to the packet-switched networks only and specifies the 
number of times ICAM will attempt to reestablish a connection over a 


switched virtual circuit to a remote subscriber. You may specify any value 
between 0 and 15. 


MXCALL= { n 
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PKTSIZ=size 
This operand applies only to packet-switched networks and specifies the 
maximum size in bytes of the data portion of a data packet. Specify a value 
according to the following list: 


DATAPAC, DATEX, IBERPAC, 
PSS, TRANSPAC 128 or 256 (default is 128) 


DDX 256 (default is 256) 
TYPE= 
Specifies the type of service supplied by the PDN in the CARRIER operand. 


TYPESCIRCUIT 
Specifies a circuit-switched public data network. 


TYPE=PACKET 
Specifies a packet-switched public data network. 


Note: For IBERPAC and PSS, the size used for input and output 
negotiation is the size specified by the PKTSIZ keyword. 
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2.18. 


2-92 


How to Specify Polling Groups and Polling 
Intervals for Remote Workstations (PGROUP) 


This macro defines a polling group for remote workstations (RWS) and the UTS 20X 
terminal (see 3.6.1 and Table 3-8). It specifies the time interval that a polling group is 
polled normally and the time interval it is polled when the group is down. 


It must immediately precede TERM macros that form a polling group of remote 
workstations or UTS 20X terminals. 


Table 2-19 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 









OPERAND 


LABEL ASOPERATIONA 







not used PGROUP 


Table 2-19. Applicability of PEROUP Macro and Its Operands 


Macro: . 
ICAM Network T id Kind of Program Supported 
PGROUP ic ietwork Type and Kin ogram Sup 


Operand Direct 


Name Data 


Interface 
Dedicated 


Networks 


Global Networks 


TCi (IMS) 
STOMCP 
STDMCP 
TCI (IMS) 
Public Data 
Networks 


a 
io} 
o 
jo} 
— 
” 
3) 
= 
s) 


*PGROUP 


PGID= 


PTIME = 





*Shows macro applicability 
LEGEND: 


R = Required O = Optional ~ = Not applicable 
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Operands 


PGID=xx 
Specifies the 2-digit hexadecimal value of the polling group remote identifier 
(rid). 





mi, 
4d oe 


face | 
Specifies the normal and slow polling intervals for this polling group. 


m 
Specifies the normal polling interval for this polling group in seconds. 
Specify a value from 1 to 255. 
n 
Specifies the slow polling interval for this polling group in seconds when 
the polling group is down. Specify a value from 1 to 255. 
Example 
1 72 
LN@1 LINE DEVICE=(RWS) , TYPE=(9600, SWCH, SYNC), ID=8, x 
RETRY=(6,4) 
PGROUP PGID=28 
TM@1 TERM FEATURES=(U2Q, 1920) ,ADDR=(28,51) ,HIGH=MAIN, MEDIUM=MAIN, x 
LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 
TM@2 TERM FEATURES=(U2@, 1920) , ADDR=(28,52) , HIGH=MAIN,MEDIUM=MAIN, x 
LOW=MAIN , AUX1=(COP, 73) , AUX2=(TP, 74) 
PGROUP PGID=29,PTIME=(2,60) (NEW POLL GROUP) 
TMO@3. TERM FEATURES=(U2@) , ADDR=(29,51) ,HIGH=MAIN, MEDIUM=MAIN, x 
LOW=MAIN , AUX1=(COP,73) , AUX2=(TP, 74) 
TMQ4 TERM FEATURES=(U2@,9600) , ADDR=(29,52) , HIGH=MAIN, MEDIUM=MAIN, X 


LOW=MAIN, AUX1=(COP, 73), AUX2=(TP, 74) 
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2.19. How to Create a Process File (PRCS) 


The PRCS macro creates a process file for temporarily storing messages. Messages 
are stored in a process file in any of four ways: 


1. ICAM places messages coming from terminals in a process file if you identify a 
process file on the INPUT operand of the LINE or TERM macro. 


2. Your MPPS routine can place messages in a process file; you identify the MPPS 
routine on the INPUT operand of the LINE or TERM macro. 


3. Your program can place messages in a process file with PUTCP macros. 
4. Messages can be placed on a process file by means of a QTRANS macro. 
Programs access the messages in a process file by issuing GETCP macros. 


A process file consists of one, two, or three queues in main storage or on disk, for low, 
medium, and high priority messages. If your program requests these messages 
without a priority level, the messages are accessed in order of priority - first the high 
priority messages, followed by the medium, and then the low. If your program does 
specify a priority level, the queues are accessed as shown in Table 2-20. 


Process files are used in standard interface and transaction control interface (IMS) 
networks. COBOL programs using the COBOL message control system require at 
least one process file for each program. Since the COBOL message control system 
needs only one queue for each process file, you should not specify a high or medium 
priority queue when defining a process file for it. You use the LOW operand to specify 
whether the single queue should be on disk or in main storage. 





Table 2-20 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 
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Format 
LABEL AOPERATIONA OPERAND 


prces-name 


,LOW=( filename 
MAIN 


MAIN 


aaa | filename } 


,HIGH=( filename 
MAIN 


,REMOTE=([ node-id 
subname,PDN |) 





Table 2-20. Applicability of PRCS Macro and Its Operands 


Ay 





eno ICAM Network Type and Kind of Program Supporte 


Operand ca 


Name ca 


interface 
Dedicated 


Networks 


Global Networks 


TCi (IMS) 
STOMCP 
STOMCP 
TCI (IMS) 


x2 | CMCS (COBOL) 
Public Data 
Networks 


“PRCS 


me) 


label 


HIGH = 


LOW= 


Oo Oo 90 


MEDIUM= 


REMOTE = 
*Shows macro applicability 
LEGEND: 
R = Required O = Optional - = Not applicable 
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Label 





pres-name 


A1- to 4-character label that identifies this process file. 


Operands 


LOW=f i lename 
Creates a low priority queue for this process file on a disk file you name ina 
DISCFILE macro. 


LOW=MAIN 
Creates a low priority queue for this process file in main storage. 


MEDIUM=f ilename 
Creates a medium priority queue for this process file on a disk file you name 
in a DISCFILE macro. 


MEDIUM=MAIN 
Creates a medium priority queue for this process file in main storage. 


HIGH=filename 
Creates a high priority queue for this process file on a disk file you name in a 
DISCFILE macro. 


HIGH=MAIN 
Creates a high priority queue for this process file in main storage. 





Note: If you omit the LOW, MEDIUM, and HIGH operands, a low priority queue 
is created for this process file in main storage. See Table 2-21 for the 
relationship between your queue specifications and the way your program 
accesses messages from the process file. 


Table 2-21. How Process File Queues Are Accessed 


PRCS Queues Specified Queues Accessed by GETCP/PUTCP or MREAD/MWRITE 
Priority Level 
No Priority Level 
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REMOTE=(node- id) 
This operand is used only in a multinode non-DCA global network. Specifies 
al-to 4-character name of the remote node where this process file is located. 
The node-id must match the label on the NODE macro that refers to the 
remote computer node. It allows your program to: 


* access messages coming from terminals attached to another system 

¢ access messages from programs using another system 

¢ send messages to programs using another system 

REMOTE=(subname , PDN) 

For packet-switched public data networks (PDN) only, specifies this process 

fileis located in a remote data terminal equipment and associates it with the 

proper subscriber to a trunk. Each remote process file must be described 

following the subscriber (SUB macro) to which it belongs. 

subname 
Specifies the symbolic name of the SUB macro in a packet-switched 
PDN that defines the remote system containing the process file. 

PDN 

e Specifies this is a public data network user. 


Example 


1 72 





PRF 1 PRCS LOW=MAIN 


PRF2 PRCS LOW=FILQU1,HIGH=MAIN 

PRF3 PRCS LOW=MAIN 

PRFA PRCS LOW=DISFL1,MEDIUM=DISFL1,HIGH=DISFL1 
PRFG PRCS LOW=MAIN,REMOTE=(COM1) 


PRFH PRCS LOW=MAIN,REMOTE=(SUB1,PDN) 
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2.20. How to Define a Permanent Virtual Circuit on a 
Packet-Switched Public Data Network (PVC) 


This macro declares the attributes of a permanent virtual circuit connecting a local 
and a remote subscriber; that is, the most recently declared local subscriber declared 
by a TRUNK macro, and the most recently declared remote subscriber declared by a 
SUB macro. 


Permanent virtual circuits are effectively point-to-point, nonswitched circuits over 
which only data, reset, interrupt, and flow control packets can flow. 


Table 2-22 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 










AOPERATIONA OPERAND 





LABEL 





LCN=number 
{, IWS=number ] 


| 


C,OWS=number ] 


symbol 
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Table 2-22. Applicability of PVC Macro and Its Operands 


ee ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 
Dedicated 


Networks 


Global Networks 


al. 
3S 
an 


STOMCP 
TC! (IMS) 


CMCS (COBOL) 
tPublic Data 
Networks 





“Shows macro applicability tPacket-switched only 
LEGEND: 
R = Required O = Optional - = Not applicable 
Label 
symbol 
Is a required 1- to 4-character label that identifies this permanent virtual 
circuit. 
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Operands 
LCN=number 

Specifies the logical channel number of this permanent virtual circuit. 

Specify as follows: 
DATAPAC 1-4095 
DATEX 1-4095 
DDX 1-255 
IBERPAC 1-4095 
PSS 1-255 
TRANSPAC 0-4095 


One line can specify up to 4096 permanent virtual circuits. 


IWS=number 
Specifies the input window size for this permanent virtual circuit. 
Window size is the maximum number of unacknowledged packets 
allowed in a transmission. It is used only for DDX, IBERPAC, and PSS 
public data networks. Valid values for DDX are 1-15, and the default is 
15. Valid values for PSS are 1-7, and the default is 7. Valid values for 
IBERPAC are 2-7, and the default is 2. 


LCGN=[ number 
Q 


Specifies the logical channel group number of this permanent virtual 
circuit. It is valid for DDX and PSS public data networks only. Valid 
values for DDX are 0-15, and the default is 0. Valid values for PSS are 
0-7, and the default is also 0. 


OWS=number 
Specifies the output window size for this permanent virtual circuit. 
Window size is the maximum number of unacknowledged packets 
allowed in a transmission. It is used only for DDX, IBERPAC, and PSS 
public data networks. Valid values for DDX are 1-15, and the default is 
15. Valid values for PSS are 1-7, and the default is 7. Valid values for 
IBERPAC are 2-7, and the default is 2. 
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2.21. How to Define Remote Data Terminal Equipment in a 
Circuit-Switched Public Data Network (RDTE) 


This macro defines the attributes of a remote data terminal equipment (RDTE) in a 
circuit-switched public data network. 


Table 2-23 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
symbol CADDRESS=rdte- address] 


[ ,ABBADDR=abbr - address] 
[ ,CUGADDR=user - grp- id] 


= { aah } 
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Table 2-23. Applicability of RDTE Macro and Its Operands 


ae 4 ICAM Network Type and Kind of Program Supported 
Operand Ea 
Name Ea 
Interface . 
Oedeered Global Networks 
Networks 
a 
a a 2 a ao g . 
fo) [J 
Zi e/o/siz of 
s/Fleleia Zé 
Pa o|Otoao|fr e2 
Fe “ 





ADDRESS= 


ABBADDR= 





CUGADDR= 
DIRECT = 





“Shows macro applicability tCircuit-switched only 


LEGEND: 


R = Required O = Optional — = Not applicable 


Label 


symbol 
Specifies the 1- to 4-character label of this macro. 
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Operands 
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ADDRESS=rdte-address 
Specifies the normal full address of the remote data terminal equipment. 
This operand is required when the address-call facility is used or when INID 
or OUTID is specified by the LDTE macro. 


ABBADDR=abbr - address 
Specifies the 2-character abbreviated address of the remote data terminal 
’ equipment. This operand must not be specified if the DIRECT=YES or 
CUGADDR operand is specified. 


CUGADDR=user - grp- id 
Specifies the closed-user-group number to use when calling this remote data 
terminal equipment. This operand must not be specified if the 
DIRECT=YES or ABBADDR operand is specified. 


tits: 


DIRECT=( WG 
YES 
Specifies that this remote data terminal equipment is using the direct-call 
facility. This operand must not be specified if the ABBADDR or CUGADDR 


operand is specified. 
DSCI=[ n 
E 


Specifies the time in seconds the connection of this remote data terminating 
equipment is held when there is no activity after input. The range is 0- 
32767. This operand is applicable only when connection is to a UTS 20X 
terminal. If 0 is specified, the connection will not be disconnected by this 
condition. 


DSCO=[ n 


Specifies the time in seconds the connection of this remote data terminating 
equipment is held when there is no activity after output. The range is 0- 
32767. This operand is applicable only when connection is to a UTS 20X 
terminal. If 0 is specified, the connection will not be disconnected by this 
condition. 


TIMER=[ n 
a 
Specifies the time in seconds the connection of this remote data terminal 
equipment is held when there is no activity. The range is 0-32767.This 
operand is applicable only when connection is to another computer. If0 is 
specified, the connection will not be disconnected by this condition. 
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2.22. 
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How to Establish Static Sessions in a Global 
Network (SESSION) 


This macro defines a static session between two global non-DCA network end users. 
It is also used to declare a static session over a packet-switched public data network 
permanent virtual circuit (PVC). For sessions between two local end users, only the 
end user operands EU1 and EU2 are required. 


Notes: 


1. Ifa-session is to be established dynamically, do not specify SESSION. For 
example, if you are using interactive services (LOCAP macro specified as 
TYPE=(DM1)) or a terminal generated as a remote workstation (DEVICE=(RWS)), 
you cannot specify SESSION to define a session path between these end users. 
Static sessions cannot be used in a Telcon environment. 


2. Do not specify the SESSION macro for any terminal that may use the terminal 
spooling capability. This includes any UNISCOPE or DCP terminal generated 
with PRIMARY or SECONDARY specified. Terminal spooling requires dynamic 
DMI sessions on both screens. 


Table 2-24 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 





LABEL AOPERATIONA OPERAND 












SESSION [CPRIMARY, ] 
EU1=(name) , EU2=(name) 


[,PVC=namej 
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SESSION 


Table 2-24. Applicability of SESSION Macro and Its Operands 









Macro ICAM Network Type and Kind of Program } HAM Network Tpe and Kind of Program Supported | 


SESSION 
ca 
ae peccated Global Networks 
Networks 


fe) 
R 
R 
R 









TCI (IMS) 
STDMCP 
STDMCP 
TCi (IMS) 
COBOL 


CMCS (COBOL) 
tPublic Data 
Networks 





“SESSION 


EU1= 








EU2= 





PVC= 


*Shows macro applicability tPacket-switched only 
LEGEND: 
R = Required O = Optional - = Not applicable 
Operands 
PRIMARY 


Indicates that this session is between an end user (such as a terminal) and a 
LOCAP file, which is the exclusive recipient of that end user’s input. A 
primary session is used when a communications user program is loaded and 
executed due to an initial input message received. If your program is not to 
be scheduled due to an initial input message, you must omit this operand. 
Note that this operand is positional and must be the first operand if 
specified. 


Note: For multiple sessions to the same process file, only one session may 
specify the PRIMARY command. 
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For example, as shown in Figure 2-2, if you define LOCAP file ‘A’ as the 
recipient of terminal T1’s input in the INPUT operand of the TERM macro 
for T1, and you specified the PRIMARY operand in a SESSION macro, only 
LOCAFP file ‘A’ could receive input from T1. Therefore, only the program 
linked to LOCAP file ‘A’ can access input messages from terminal T1. 
Terminal T1 can, however, receive output messages from CUPs 1, 2, and 3. 


EU1=(name) 
Is al- to 4-character name of a local end user as defined in the label field of 
a LOCAP, TERM, or PRCS macro in this network definition. 


EU2=(name) 
Is al- to 4-character name of a local or remote end user as defined in the 
label field of a LOCAP, TERM, or PRCS macro. 





2-WAY TRAFFIC 


LOCAP 





T1 





OUTPUT ONLY TRAFFIC 





SESSION PRIMARY,EU1=(A),EU2=(T1) 
SESSION EU1=(B),EU2=(T1) 
SESSION EU1=(C),EU2=(T1) 


Figure 2-2. Specifying a Primary Session 


PVC=name 
Is the symbolic name of the permanent virtual circuit in a packet-switched 
public data network over which this static session is conducted. Specify the 
label of the PVC macro that defines the permanent virtual circuit used. 


You may only define one static session over each permanent virtual circuit. 
All SESSION macros associated with a given trunk must be grouped 
following the end user declarations for that trunk. 
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Example 


In the following example, Al is the symbolic name of the local end user, A2 is the 
symbolic name of the remote end user, and V0 is the symbolic name of the 
permanent virtual circuit used to establish a static session. 


SESSION EU1=(A1) ,EU2=(A2) ,PVC=VO 


Note: You cannot establish static sessions over switched virtual circuits. 
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2.23. 
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How to Define a Station Profile Table 
(STATION) 


This macro creates a station profile table for each station (local and remote) connected 
to the specified VLINE. It specifies the unique characteristics of a particular station 
and the flow control parameters required by the link level control module. Use this 
macro only when DEVICE=NRM is specified on the VLINE macro. 


Table 2-25 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 








LABEL AOPERATIONA OPERAND 










PRIMARY ) 
SECONDARY 


{,ADDRESS=nn] 
[, CALL=phone-number ] 
[, LINE=vl ine-name] 


«MAXIFLD={ nnnn 
268 


[ ,REMOTE=node-name] 


aad valu ] 





STATION iagcae| 
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Table 2-25. Applicability of STATION Macro and Its Operands 


Sey ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 


















Dedicated 
Networks 


Global Networks 














TCi (IMS) 


STOMCP 
CMCS (COBOL) 


TCI (IMS) 
Public Data 
Networks 





*STATION 
symbol 
TYPE= 
ADDRESS 


CALL 
LINE 


MAXIFLD 
REMOTE 


WINDOW 


“Shows macro applicability 


LEGEND: 


R = Required O = Optional - = Not applicable 


Label 
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symbol 


STATION 


Is a required 1- to 4-character name that is specified as the REMOTE= 
keyword parameter on the LPORT, TERM, and LOCAP macros associated 


with this station. 
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STATION 


Operands 


TYPE= 


CTWA, [ PRIMARY ) 
SECONDARY 


Specifies characteristics of this station. 


TWA 
Indicates that this logical station operates in a two-way-alternate 
(TWA) mode. In this mode, the station cannot send and receive 
simultaneously. 

PRIMARY 
Indicates that the station is configured for primary link control. 

SECONDARY 


Indicates that the station is configured for secondary link control. 


Note: When two UDLC/NRM stations are connected over a link (VLINE), 
one station must be defined as primary and the other as secondary. 
For UNIX O/S file transfers, the OS/3 system is the primary station 
and the UNIX O/S is the secondary station. 


ADDRESS=nn 


Specifies a two-digit, hexadecimal (01 to FE) address of the secondary 
station on a local or remote node. 


CALL=phone-number 


A numeric or alphanumeric telephone number used to dial out from the OS/3 
system, 


LINE=vlt jine-name 


Specifies the name of the VLINE. Use this operand only for local stations. 


MAXIFLD=[ nnn 


2-110 


Specifies the maximum I field size of a frame received from a remote station. 
Calculate the maximum I field size by subtracting the size of the UDLC 
header from the maximum size of the DCA header (13 bytes) and adding 
that difference to the maximum user data size of a frame. 


Note: The link buffer size specified on the LINKPAK parameter of the 


BUFFERS macro must be large enough to support this maximum 
frame size. 
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STATION 


ee eS 8 eo 


REMOTE=node -name 
Indicates that this station is defined on a remote node. If this parameter is 


not specified, the station is considered a local entity. 


aie | ea 


Specifies the number of frames (1 to 7) that can be sent from this station 
before an acknowledgement is required. 
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2.24. How to Define a Remote Subscriber on a Packet- 
Switched Public Data Network (SUB) 


This macro declares the attributes of a remote subscriber data terminal equipment 
(DTE) in a packet-switched public data network. 


One or more SUB macros must appear following each TRUNK macro. You establish 
logical connections between local and remote data terminal equipments by relating 
TRUNK and SUB statements; i.e., all remote subscribers declared in SUB macros 
following a TRUNK macro can communicate with the local data terminal equipment 
using that trunk. 


Table 2-26 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
symbol CALLNO=dte- address 





,CALLING=( WiO7 
YCES] 


fal closed-user - group- code } 
] 





[, IWS=input-window-size] 





;NEGO=/ N[O} 
YCES] 


[ ,OWS=output-window-size] 


;REVCHG=[ NEOY | 
YLES] 
ACP 
REQ 
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Table 2-26. Applicability of SUB Macro and Its Operands 


Macro: 
SUB 


Operand Direct 
Name ‘Data 
Interface 





ICAM Network Type and Kind of Program Supported 













Dedicated 
Networks 








Global Networks 





a 
® ja 2 ao | ® 2» 
a 
S/28 Sto}; st 6 6 <= 
= 2 oS 2 =} a 23 
O;/Fi Biel s 8 go 
FE | ole a2 
2 = 







“SUB 







label 


CALLNO 







CALLING 
















CATP= - 7 - - = = = 
CUG 

Iws= 
MUX= 


NEGO 






OWS= 







REVCHG= 


o0o Oo oO 80 0 Oo Oo 8 


*Shows macro applicability tPacket-switched only 
LEGEND: 
R = Required O = Optional - = Not applicable 
Label 
symbol 


Is a required 1- to 4-character label used to reference this macro. 
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Operands 


CALLNO=dte-address 
Specifies the level 3 DTE address of the remote subscriber. You obtain this 
information from the public data network at subscription time. 





CALLING={ WLOJ 
YES] 
Specifies whether the local DTE address is included in the call request 
packet for switched virtual cireuits (SVCs). This operand applies only to the 
IBERPAC public data networks. 


CATP= 
Specifies the category of procedure used by this remote subscriber for system 
session control and port flow control. 


CATP=F 
Specifies an OS/3 to VS/9 public data network connection. 


CATP=G 
Specifies host-to-host or host-to-UTS 4000 dynamic sessions over 
switched or permanent virtual circuits. This protocol is the primary 
category of procedure and is supported for all networks. 


CATP=H 
For DDX networks only, specifies host to foreign node over permanent 
virtual circuits using static sessions. You must specify category H and 
-noncategory H subscribers on the same trunk. 


a closed-user -group-code 
4 


Specifies the closed user group code for this subscriber. This optional facility 
permits a group of users to communicate with each other, but prevents 
communications with others not in the group. If you do not specify this 
operand, the value zero (0) is used; this is the value assigned to all users that 
do not belong to a closed user group. Valid values for this operand are 0 - 99. 


IwS={nput-window-size 
Specifies the level 3 input window size used for all switched virtual circuit 
connections between the local data terminal equipment and this remote 
subscriber. This operand is valid for DDX, IBERPAC, and PSS public data 
networks only; other networks use the WS parameter in the TRUNK macro. 
Valid values for DDX are 1-15, and the default is 15. Valid values for 
IBERPAC are 2-7, and the default is 2. Valid values for PSS are 1-7 and the 
defaultis 2. © 


MUX= 





NCO] 
Specifies whether all dynamic sessions with this subscriber are multiplexed 
over a single virtual circuit. NO specifies that messages are not multiplexed. 
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YLES] 
Specifies the level 3 negotiator option. This operand is valid for IBERPAC 
and PSS public data networks only. 


as | NfO] 


OWS=output-window-size 
Specifies the level 3 output window size used for all switched virtual circuit 
connections between the local data terminal equipment and this remote 
subscriber. This operand is valid for DDX, IBERPAC, and PSS public data 
networks only; other networks use the WS parameter in the TRUNK macro. 
Valid values for DDX are 1-15 and the default is 15. Valid values for 
IBERPAC are 2-7, and the default is 2. Valid values for PSS are 1-7 and the 
default is 2. 


REVCHG=NIOJ 
Specifies that collect calls will not be accepted. 


REVCHG=YLES] 
Specifies that the local subscriber will accept collect calls from the remote 
subscriber. 


REVCHG=ACP 
Specifies that the local subscriber will only accept (not request) collect calls 
from the remote subscribers. 


REVCHG=REQ 


Specifies that the local subscriber will only request (not accept) collect calls 
to the remote subscriber. 
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2.25. How to Specify Terminal Characteristics 
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(TERM) 


This macro specifies the characteristics of each terminal in your communications 
network. You must supply one of these macros for each terminal or screen bypass 
terminal. Each TERM macro must be placed following the DCPCHNL, LINE, or 
VLINE macro that specifies the communications line to which the terminals are 
attached. You can only specify one TERM macro per LINE macro when defining UTS 
20D local workstations, and two TERM macros for UTS 40D and SVT 1122 local 
workstations. 


Table 2-27 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
term-name FEATURES=} ( } BSC 
2788 
3780 
278@EM 
3780EM 


£,max-output-record- length] 


MULTI 


{ max-no-records-per-block | 
‘4 


+f SECOND {, TRANSPARENT] 
PRIMARY 


(, transparent: input-record-length} 
[,max-block- length} 


[,NOSTX]) 








aa AMS Z| Hf: on 
TIP EOT ,HRTB 
¢ DCT475 
| DCT52@ | 
ocT524 | ) 
continued 
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TERM 


LABEL AOPERATIONA OPERAND 


term-name TERM (cont.) FEATURES= 


(cont.) | (DCT200@[,SBLK] |,[{ 8@ 
128 ) 


(TTY) 
(TTYEM) 


(u20 |,{ 960 [,SBTIL,CC) |,f{ PRIMARY 
1920 SECONDARY [|) 


(u4@ |,f{ 96@ }| [,CC) |,f PRIMARY 
1920 SECONDARY [|) 


(u1ee |,f 960. 
1024 |» 


(u200 |,{ 1536 
1920 []) 


(U40@ | ,| 960 [,SBT] cp } fs 
PR 


(U408TE) 


(1004 |,,f DLTS 
DLT1 f1) 


(1122) 


(3271 nec} ‘{ 4928 } ; { LAMP } 
) 


| privren | 488 ALARM 


(3277,[ PASS 


|| { ous 


(9308 


t 
| 

“el cr 
i 





continued 
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TERM 




















SOPERATIONA OPERAND 





term-name TERM (cont.) 





,ADDR=(] rid,sid 
dev-addr 
mn,nn ) 


( ,ALTD=alt-dest] 

( ,ANSWER=( integer ,C, text) ] 

[ ,AUX1=(aux-dev-id)[,...,AUX44=(aux-dev- id) )] 
{, CALL=phone-number } 


,DESPACE={ J 
Y 
N 


_ 1 
»DICE=(f ON ),{ NEWLINE 
OFF{ ) FORMS f) 
J 
[,DISIN=n} 
[,DISOUT=n] 


{,DVCGID=terminal -group-name] 
C, INHIBIT=YES} 
[, INONLY=YES] 





kee name pene ne 
YES 


96 


, INRECSZ=[ 80 
128 


INTERCPT=[ YES 
filename 


,LOW=[ filename 
MAIN 


saad | filename } 


,MEDIUM=[ filename 
MAIN 
| MAIN 


continued 
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LABEL AOPERATIONA OPERAND 


term-name TERM (cont.) [ ,MSGWAIT=(message) J 
[,QUTONLY=YES] 


aes | tenths-of-second } 
Ae 


{,PLIMIT=integer} 
C,PROFIL=n] 


»PROTYP={ BEY 
INT-1 
RB-2 
[,PSEUDO=Tel con- term-name] 
,RBATCH=f WO 
YES 


sREMOTE=(f node-id 
subname PON, [PT1 f) 


, SCREENS=( { n } 
Ss 





{,subtype]) 
/SPR=f 68 
seconds 
(, TCTUPD=YES] 
C, TIMEFILL=NO] 
»XLATE=( _| YES 
NO NO 
labeli, idi labelo, ido ) 





Note: For ease of use, the FEATURES operand is presented first in the format and 
operand descriptions that follow. The remaining operands are presented in 
alphabetical order. 
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Table 2-27. Applicability of TERM Macro and Its Operands 


oa 1ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name ca 
ca m 
Dedicated Global Networks 
Networks 


TCt (IMS) 
STOMCP 
2 | CMCS (COBOL) 
STOMCP 
TC! (IMS) 
tPublic Data 
Networks 


Ps] 


O 
ie) 
Oo 





AUX44= 


CALL= 
DESPACE= 


DICE= 
DISIN= 
DISOUT = 
DVCGID= 


HIGH= 
INHIBIT = 


INONLY-= 


INPUT= ; 
: continued @ 
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Table 2-27. Applicability of TERM Macro and Its Operands (cont.) 


wai ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name ca 
ca 


Dedicated 
Networks 


Global Networks 





Oi} 8 ao| @ £ » 
Ss|o]/O} 90 2 Gx 
ag leo ee $3 
Pe |b Q ma |e ee 
S - 
INRECSZ= - 
INTERCPT = ce) 
0 
Oo 
10) 
OUTONLY = Oo 
PINTV = Oo 
PLIMIT = Oo 
PROFIL= 0 
PROTYP= 
PSEUDO = 
RBATCH= 
REMOTE= 
SCREENS= 
SPR= 
TCTUPD= 
TIMEFILL= 
XLATE = 
tPacket-switched only ttAlso circuit-switched PDNs tttDATEX-t PDN only 
LEGEND: 
= Required O = Optional — = Not applicable 
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Label 


term-name 
Is a 4-character label that identifies this terminal. 


Notes: 


1. When running in the DCA=YES environment with LPORT macro(s) specified, 
an A023 message may result in the SGSCOMMK assembly step if the first 
character of the label is Z. 


2. If this terminal is defined by a TERM statement in a Telcon generation and 
the Telcon terminal name is greater than 4 characters and not more than 8 
characters, use the PSEUDO keyword to match the terminal names correctly. 


Operands 


FEATURES= 
Identifies the characteristics of this terminal and the features supported. 


Note: These operands are positional. That is, if you do not specify an 
optional suboperand, you must code a comma to indicate the 
defaulted suboperand; except, do not specify a trailing comma. 
For example, you can code either of the following: 


FEATURES=(U2Q, 1024, SBT) 


FEATURES=(U20,,, ,PRIMARY) 
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BSC 
2780 
3780 


TERM 


2780EM 
3780EM 


(,max-output-record- length] 


MULTI 


| max-no-records-per -block | 
2 


,{ SECOND L, TRANSPARENT] 
PRIMARY 


[, transparent- input-record-length] 
{,max-block- length] 


= 





{,NOSTX]) 






MODEL3 
MODEL4 


Establishes the requirements for binary synchronous communications 
as follows: 


BSC 


2780 


3780 


Indicates that communications are between this computer and a 
remote computer or between this computer and any terminal that 
adheres to standard binary synchronous communications protocol 
(BSC). This operand incorporates the general mode of the BSC 
remote device handler. If you specify only FEATURES=(BSC), it 
defaults to FEATURES=(BSC,80,1,SECOND,,80,84). 


Indicates that this terminal is an IBM 2780 or 3741, or a UDS 2000 
or UNIX O/S terminal emulating an IBM 2780. When you select 
this operand, all hardware requirements of the terminal are 
handled. This operand incorporates the terminal mode of the BSC 
remote device handler. If you specify only FEATURES=(2780), it 
defaults to FEATURES= (2780,80,2,SECOND). 


Indicates that this terminal is an IBM 3780 or a UNIX O/S 
emulating an IBM 3780. When you use this operand, output 
blanks are space-compressed (except in transparent mode). When 
you specify only FEATURES=(3780), it defaults to FEATURES= 
(3780,80,2,SECOND). 
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278@GEM 
Indicates that the System 80 is emulating an IBM 2780 terminal. 


3780EM 
Indicates that the System 80 is emulating an IBM 3780 terminal. 


max-output-record-tength 
Is a decimal number that specifies the output print line length. If 
you omit this suboperand, a value of 80 is used. 


MULTI 
2 
Is a decimal number that specifies the maximum number of records 
that may be transmitted in a block. If you specify MULTI, 7 is 
used. If you do not specify this suboperand, 2 is used. 


SECOND 
PRIMARY 


Specifies the remote device handler priority. 


max-no-records-per -block 


TRANSPARENT 
Specifies this terminal includes the transparency feature. You may 
only specify this if you also specify DEVICE=(BSC,,EBCDIC) in the 
LINE macro. 


transparent- input-record-tength 
Is a decimal number that specifies the fixed length of transparent 
input records. If you specify zero (0), single-record transparent 
input of arbitrary length is assumed. In this case, ITB, DLE, and 
STX characters are passed to your program if they are present ina 
message. If you omit this suboperand, 80 characters are assumed. 
This suboperand is valid only if yous also specify the 
TRANSPARENT suboperand. 


max-block- length 
Is a decimal number that specifies the maximum number of 
characters (excluding STX and DLE) that can be sent in a block. If 
you specify 2780 or 3780, and do not specify this suboperand, 200 is 
assumed. If you specify 2780 or 3780 and the max-no-records- -per- 
block suboperand as 2 or MULTI, and if you do not specify this 
operand, 400 is assumed. If you specify BSC, the default is 200. 
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MODEL3 
MODEL4 


Specifies the output devices available on this IBM 2780 terminal. 


MODEL 1 
Indicates the printer. 


MODEL2 
Indicates a printer and a card punch. 


MODEL3 
Indicates the printer (the terminal has no card reader). 


MODEL4 
Indicates the card punch. 


NOSTX 
Specifies a STX character is inserted into the first record of 
multirecord messages. This suboperand is valid when BSC is 
specified and max-no-records-per-bilock is greater than one. 


c1esc,{ iS ),{ WABF 17,8 ,PRI, TRANS) 
TIP EOT f],HRTB 


IBSC 
Indicates a remote CPU in inquiry/response session with an 
IMS/TIP30 LOCAP. (Not batch mode file transfer.) 


TIP 


Specifies the user program. IMS is the default. 


Specifies the type of delay character the other CPU expects if 
ICAM must delay input due to lack of resources or an available 
input slot. Wait-a-bit (WABT) is the default. 








{ NU 
,HRTB 
NULL passes the no heartbeat (HRTB) message to the user. NULL 

is the default. HRTB displays the text message HRTB in order to 
notify the user program when a downed CPU comes back online. 
This is only operational in a dedicated CCA. In the dedicated CCA, 
you can also use the PINT'V= parameter to specify a time delay 
before testing if the other CPU is back online. 
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PRI 
Specifies that OS/3 ICAM is the primary station. Secondary is the 
default. 
TRANS 
Allows transparent text transfers. It is still the user’s 
responsibility to specify transparent transfer of output to 
IMS/TIP30 (same as transparent aux print, but without an aux 
device). 
« | DCT475 
DCT500 
DCT524 | ) 
Identifies this terminal as a 475, 500, or 524 data communications 
terminal. 
(DCT2@00L , SBLK} 





{8 


Identifies this terminal as a DCT 2000 data communications terminal 
and indicates the features it contains. SBLK indicates the terminal 
uses the short block feature. 128 indicates the terminal is set to receive 
and print 128 characters, rather than 80 characters. 


(TTY) 
Identifies this terminal as a teletypewriter or as a UTS 10 single 
station. 


(TTYEM) 
Identifies an uncontrolled, full-duplex, TTY-like device. Use this 
parameter when you specify DEVICE=(TTYEM) in the LINE macro. 
You may specify only one TERM macro for each TTYEM line. 


-f[ 960. }| C,SBTIC,CC] |,{ PRIMARY 
1920 { SECONDARY } ) 


Specifies that this is a UTS 20 set to display 960 or 1920 characters. 
See Appendix B for details and examples of the U20 suboperand. 


(U2 
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You can indicate U20 for the following devices: 


UTS 20 
SVT 1120, SVT 1123, SVT 1124 
PC using UNISCOPE emulation provided by STEP 


UNIX O/S UNISCOPE emulation provided by the Programmable 
Communications Controller 


UTS 20D local workstation (LWS) 


UTS 20W attached to a UTS 4020 or 4040 cluster controller 


Notes: 


1, 


SBT 


cc 
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You can generate the SVT 1120, SVT 1128, and SVT 1124asa UTS 
20 or asa UTS 40. 


You can define a UTS 20, SVT 1123, SVT 1124, and PC (utilizing 
STEP to provide UNISCOPE emulation) as a terminal or asa 
remote workstation. 


A UTS 20D functions in a single-station mode. You must therefore 
define a LINE macro for each local workstation TERM macro. 
Since a UTS 20D is a single-screen device, it has no auxiliary 
printing or second-screen support. 


PRIMARY /SECONDARY does not apply to a UTS 20D local 
workstation. 


Specifies that this terminal has the screen bypass feature. The sid 
assigned must be one greater than the last actual terminal in the 
group. (See ADDR operand). 


Specifies that this terminal is a UTS 20W workstation connected to 
a UTS 4020 or 4040 cluster controller. This operand is not used for 
workstations connected to a cluster controller in a public data 
network or for a single-station UTS 20 terminal (RWS). 
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PRIMARY/SECONDARY 


Specifies the primary or secondary screen on a dual-screen device. 
If you don’t specify this parameter, the device is considered single- 
screen. If you do specify it, you must also supply two TERM 
macros (one for each screen). The macro definitions are the same 
except the first TERM macro must specify PRIMARY and the 
second must specify SECONDARY. 


The station address (sid) you specify for the second display screen 
must be one higher than the sid you specify for the primary display 
screen. 


PRIMARY/SECONDARY need not be specified unless remote or 
terminal spooling is desired. 


Notes: 


1, 


Auxiliary printer spooling support provided by the OS/3 operating 
system requires a dual-screen device. You must specify the 
PRIMARY /SECONDARY parameter to use this facility. 


The I/OGEN section of the system generation parameters contains 
the statements REMWORKSTATION AMOUNT=n and 
SCRENMEM=m. Use these statements to indicate the maximum 
number of single- and dual-screen communications devices 
supported by interactive services on your OS/3 system. For 
example, if your system supports 10 single-screen UTS 20s and 5 
dual-screen UTS 20s, include the following statements in your 
system generation parameters: 


REMWORKSTATION AMOUNT=1@8 SCRENMEM=1 
REMWORKSTATION AMOUNT=5 SCRENMEM=2 
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(U6@ |,f 960 }} £,CC] |, [ PRIMARY 
{ "820 ee ) 


Specifies that this is a UTS 40 set to display 960 or 1920 characters. 
See Appendix B for details and examples of the U40 suboperand. 


You can indicate U40 for the following devices: 


UTS 30, UTS 40 
SVT 1120, SVT 1123, SVT 1124 


PC using UNISCOPE emulation provided by STEP (level 2R1 or 
higher) 


UTS 40D local workstation (LWS) 


UTS 40W attached to a UTS 4020 or 4040 cluster controller 


Notes: 

1. You can generate the SVT 1120, SVT 1123, and SVT 1124 asa UTS 
20 orasa UTS 40. 

2. Youcan define a UTS 30, UTS 40, SVT 1123, SVT 1124, and PC 
(utilizing STEP to provide UNISCOPE emulation) as a terminal or 
as a remote workstation. 

3. AUTS 40D functions in a single-station mode. You must therefore 
define a LINE macro for each local workstation TERM macro. 
Since a UTS 40D is a dual-screen device, you must define two 
TERM macros in order for ICAM to use data mode on screen 2, 

4. PRIMARY/SECONDARY does not apply to a UTS 40D local 


cc 
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workstation. 


Specifies this terminal as a UTS 40W workstation connected to a 
UTS 4020 or 4040 cluster controller. 


Note: Do not specify this operand for a packet-switched cluster 


controller in a PDN or for a single-station UTS 40 terminal 


(RWS). 
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PRIMARY/SECONDARY 
Specifies the primary or secondary screen on a dual-screen device. 
If you don’t specify this parameter, the device is considered single- 
screen. If you specify the parameter, you must also supply two 
TERM macros (one for each screen). The macro definitions are the 
same except the first must specify PRIMARY and the second must 
specify SECONDARY. The station address (sid) you specify for the 
second display screen must be one higher than the sid you specify 
for the primary display screen. 


PRIMARY/SECONDARY need not be specified unless remote or 
terminal spooling is desired. 


Notes: 


1. Auxiliary printer spooling support provided by the OS/3 operating 
system requires a dual-screen device. You must specify the 
PRIMARY /SECONDARY parameter to use this facility. 


2. TheI/OGEN section of the system generation parameters contains 
the statements REMWORKSTATION AMOUNT=n and 
SCRENMEM=m. Use these statements to indicate the maximum 
number of single- and dual-screen communications devices 
supported by interactive services on your OS/3 system. For 
example, if your system supports 10 single-screen UTS 40s and 5 
dual-screen UTS 40s, include the following statements in your 
system generation parameters: 


REMWORKSTATION AMOUNT=12 SCRENMEM=1 
REMWORKSTATION AMOUNT=5 SCRENMEM=2 


(U108 |, f 960. 
26 |) 


Identifies this terminal as a UNISCOPE 100 display terminal or a UTS 
400 operating similarly to a UNISCOPE terminal]; set to display 960 or 
1024 characters (12 x 80 or 16 x 64 screen). Also identifies a UDS 2000 
operating in a UNISCOPE mode, or a V77 Series data processing 
system emulating a UNISCOPE 100 display terminal. 
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(u200 |,{ 1536 
1920 []) 


Identifies this terminal as a UNISCOPE 200 display terminal or a UTS 
400 operating similarly to a UNISCOPE terminal; set to display 1536 or 
1920 characters (24 x 64 or 24 x 80 screen). 


Note: For OS/3 to MAPPER 5 connectivity, you must specify FEATURES= 
(U200,1920). 


(U400 |,[ 960 [,s8T] |,f{ cP} |C,cc2) 
1024 { PR } 
1536 
1920 


Specifies this terminal is a UTS 400 or UTS 4000 operating in the UTS 
400 mode set to display 960, 1024, 1536, or 1920 characters. See 
Appendix B for details and examples of the U400 suboperand. 


SBT 
Specifies the screen bypass feature. The station address (sid) 
assigned must be one greater than the last terminal in the group 


(see ADDR operand). 

cP 
Specifies the U2 mode of the character protection feature, and that 
this terminal is configured as a UNISCOPE with up to 80 
protection changes per line. Special function keys 5 - 22 are 
enabled and Katakana is disabled. 

PR 


Specifies PROTECT/FCC is set to PROTECT. Terminal is 
operated as a UNISCOPE but is limited to 15 protection changes 
per line. Special function keys 5 - 22 and Katakana are disabled. 


Note: If this terminal functions as a UTS 400 or UTS 4000, do not 
specify PR or CP. 
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cc 
Specifies this terminal as one of a UTS 400 cluster. A cluster is 
defined as two or more terminals attached to a UTS 400 controller, 
or one or more terminals attached to a master UTS 400 terminal. 


Specify CC for all terminals in the cluster. Do not specify CC for a 
stand-alone master UTS 400 terminal or a UTS 400 controller with 
only one terminal. 


(U4B@TE) 
Identifies this terminal as a UTS 400 text editor. The screen size is 
1920 characters (24 x 80 characters). 


(1004 |,,{ BLT3 
pLT1 f}) 


Identifies this terminal as a 1004 card processor system and the data 
line terminal (DLT1 or DLT3) used. The extra comma denotes an 
unused suboperand. This operand is also used to identify a V77 Series 
data processing system emulating a 1004 remote card processor system. 


(1122) 
Specifies that this is an SVT 1122 local workstation. Since the SVT 
1122 is a dual-screen device, you must define two TERM macros in 
order for ICAM to use data mode on screen 2. 


(3271 |,{ DISPLAY +f 1920 ,{ LAMP 
PRINTER 480 ALARM 


Identifies the terminal device as an IBM 3277 display station or 
3284/3286 printer. 





) 











PRINTER 
DISPLAY specifies an IBM 3277 display station. 
PRINTER specifies an IBM 3284 or IBM 3286 printer. 


The default is DISPLAY. 





3920 

480 
1920 and 480 refer to the screen size or print position size of the 
display station or printer. The default is 1920. 
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LAMP 
Specifies that the unsolicited message (USM) is sent to the 
display station by the remote device handler. 


ALARM 
Specifies that the remote device handler should send a 
message to actuate the audible alarm of the display station. 


If omitted, a /‘CMW message is sent to the display station by the 
remote device handler. For the printer, this parameter is ignored. 


(3277, [ PASS 
STRIP 
) 


CONV 
Identifies the terminal device as an emulated IBM 3277 display station. 


PASS 
On input and output, the message text is passed between your 
program and the IBM host with no modification performed. The 
DICE specification is ignored. The message text contains the IBM 
defined orders (i.e., set buffer address, attribute byte), and input 
messages contain the IBM command sequence. 


STRIP 
Provides for passing of unformatted (screen) data between your 
@ program and the IBM host. On input (from the IBM host), all IBM 
orders are stripped from the message; DICE is ignored. On output, 
the text is not modified. If you specify DICE=ON, the DICE 
sequence at the beginning of the message is converted to the cursor 
address. 


CONV 
Message text field control characteristics are converted between 
IBM attribute byte (ATB) orders and UTS 4000 field control 
character sequences. Conversion between DICE and set buffer 
address (SBA) is performed if DICE=ON. Conversion between all 
other IBM orders and UTS ESC sequences is performed as 
described in the ICAM Standard MCP Interface Programming 
Guide (UP-8550). 
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(9200 |,[ 96 sof BUTS 
120 DLT1 []> 


132 


Identifies this terminal as a 9200 system connected to ICAM asa 
communications terminal. 96, 120, or 132 identifies the length of a 
print line. DLT3 or DLT1 identifies the data line terminal used. The 
extra comma denotes an unused suboperand. 


(9300 |,,{ OLT3 
DLT1 } ) 

Identifies this terminal as a 9300 system connected to ICAM asa 

communications terminal, DLT3 or DLT! identifies the data line 

terminal used. The extra comma denotes an unused suboperand. 


ADDR=(| rid,sid 
| dev- addr | 
mn,nn ) 
Identifies the remote identifier and station identifier for a specific terminal, 
the device address for a local workstation terminal, or the screen number for 


a packet-switched PDN UTS 4000 terminal. 


ADDR=(rid, sid) & 


Is the hardware address of a polled terminal as wired into the terminal 
by field installation technicians. You must specify this operand for 
polled terminals such as: 








¢ UNISCOPE 100/200 terminals 
¢ UTS 400/4000 terminals (all versions) 
¢ DCT 500 terminals operating in automatic mode 
e IBM 3270 terminal systems 
¢ IBM 3270 emulator 
rid 
Is two hexadecimal digits that identify the remote device address wired 
in the terminal. The allowable range of addresses is 21,, to 4F,,. For 
IBM 3270 terminals, rid specifies the IBM control unit (cu) address. 
sid 
Is two hexadecimal digits that identify the station address wired in the 


terminal. The allowable range of addresses is 51,, to 6F,,. For IBM 
3270 terminals, sid specifies the IBM device (dev) address. 
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Notes: 


q, 


2. 


The rid/sid combination must be unique for each terminal on a line. 


For DCT 500 terminals operating in automatic mode, rid/sid definitions 
must be unique for each terminal on a line. However, any ASCII value 
may be used. 


For UNISCOPE 100/200 and UTS 400/4000 terminals using polling 
groups: - 


¢ All terminals in a polling group must have the same rid (sids within 
a polling group must be unique). 


¢ TERM macros for terminals in a polling group must be contiguous 
in your network definition. 


For example: 


LINE ... Line macro for this line 

TERM ... ADDR=(21,51) ... polling group 1 on this line, terminal 1 
TERM ... ADDR=(21,52) ... polling group 1 on this line, terminal 2 
TERM ... ADDR=(21,53) ... polling group 1 on this line, terminal 3 
TERM ... ADDR=(22,51) ... polling group 2 on this line, terminal 1 
TERM ... ADDR=(22,52) ... polling group 2 on this line, terminal 2 
TERM ... ADDR=(22,53) ... polling group 2 on this line, terminal 3 


For the UTS 400 terminals, each terminal in a polling group 

(master /slaves to terminal controller /slaves) must use the same rid. The 
sid for each terminal must be assigned in contiguous ascending order 
with the master (or the primary terminal) designated as the lowest value 
sid. If the screen bypass function is utilized, the sid designated for this 
function (specified in an additional TERM macro) must be the next 
available sid (one greater than the sid assigned to the last actual 
terminal in the group). 


When specifying terminal addresses for the non-PDN UTS 20 (with 
screen bypass feature) and UTS 40, the dual-screens are separately 
addressed and require separate and distinct definitions. You must 
specify two TERM macros (each appropriately defining one rid, sid) for 
each UTS 40 and dual-screen UTS 20. The addresses must be 
consecutive. For example: 


TRIA TERM ... ADDR=(35,51) ... SCREEN A 
TRIB TERM ... ADDR=(35,52) ... SCREEN B 


For OS/3 to MAPPER 5 connectivity, the rid, sid terminal address for 


the MAP5RDH line must correspond to the rid, sid terminal address 
definition configured on the MAPPER 5 system for the MAP5RDH line. 
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7. For IBM 3270 emulated terminals, the CU/DEV addresses identifying 
the IBM control unit and device addresses must match the addresses 
generated in the IBM host, and conform to the address values and 
sequences as specified for the IBM 3277 display station. See Appendix C 
for a table that shows the valid CU/DEV addresses and their EBCDIC 
I/O characters and hexadecimal values. 


The following is a network definition for a global network that provides 
both LWS and user program (CUP) session communication with the 
IBM host connected to the 3270 emulator on LNE1. It includes two local 
workstations (LWS3 and LWS4) and a communications line (LNE1) to 
the IBM host with two "pseudo" terminals (TRM1 and TRM2). The local 
workstations, LWS3 and LWS4, can establish dynamic sessions with 
TRM2. A static session is defined between TRM1 and CUP1. The IBM 
control unit address is Cl, and the two terminal device addresses are 
TRM1 (40) and TRM2 (CL). The CU address must be the same for all 
displays on the line. 


NETI CCA TYPE=(GBL,,S) 
BUFFERS 200,64,0,ARP=50 
cuP1 LOCAP TYPE=(STDMCP) , LOW=MAIN 
LNE1 LINE DEVICE=(INV3271), x 
TYPE=(2400, SYNC), 
ID=11, 
XLATE=(NO,NO) 
TRM1 TERM FEATURES=(3277, STRIP), 
ADDR=(C1,42), 
LOW=MAIN, 
INPUT=CUP1, 
DICE=(ON) 
TRM2 TERM FEATURES=(3277), 
ADDR=(C1,C1), INPUT=(YES), 
LOW=MAIN, X 
DICE=(OFF) 
LNE2 LINE DEVICE=(LWS) ,LBL=1200 
LWS3 TERM FEATURES=(U2Q) , ADDR=(312) , INPUT=(YES) 
LNE3 LINE DEVICE=(LWS),LBL=1200 
LWS4 TERM FEATURES=(U2Q) , ADDR=(313), INPUT=(YES) 
SESSION EU1=(CUP1),EU2=(TRM1) 
ENDCCA 





~~ 


<< KK 
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ADDR=(dev- addr) 
Identifies a specific local workstation terminal address allocated to 
ICAM. 


For models 4 and 6, the allowable addresses are 311-318, 331-338, 
341-348, 351-358, 361-368, 371-378, and 381-388. Your hardware 
configuration determines the actual optional device addresses in the 
340, 350, 360, and 370 ranges. For more details, see the Hardware and 
Software Programming Quick-Reference Guide (UP-8868). 


For models 8, 10, 15, and 20, the allowable addresses are C11-C18, 
C31-C38, C41-C48, C51-C58, C61-C68, C71-C78 C81-C88, E11-E18, 
E31-E38, E41-E48, E51-E58, E61-E68, E71-E78 and E81-E88. 


For dual-screen local workstations (UTS 40D and SVT 1122), two 
TERM macros may be specified for the LINE. Each TERM macro on a 
given line should have the same ADDR value. For example: 


1 72 


LNE3 LINE = DEVICE=(LWS),LBL=1200 
C11A TERM  FEATURES=(U4@) , ADDR=(C11) , AUX1=(PRNTR) , INPUT=(YES) , LOW=MAIN 
C11B 4 =TERM FEATURES=(U4@) ,ADDR=(C11) ,AUX1=(PRNTR) , INPUT=(YES) , LOW=MAIN 


ADDR=(mn,nn) 
The UTS 20(W) and UTS 40(W) workstations attached to the UTS 4020 
or UTS 4040 in a packet-switched public data network are addressed by 
screen number. The number consists of a 2-digit ASCII number that 
represents a decimal equivalent as follows: 


30,31 =1 
30,32 = 2 
30,39 =9 
31,30 =10 


Note: Do not specify the ADDR operand for single-station teletypewriters, 
such as the DCT 500 or the UTS 10. 


ALTD=alt-dest 
Defines the label of an alternate process file, terminal, or LOCAP where you 
want output messages sent if this terminal is unable to receive them. 


If this terminal is marked down by ICAM before ICAM dequeues the output 
and you have specified ALTD, ICAM sends the message to the alternate 
destination. If ALTD is not specified, but an intercept queue is available 
(see INTERCPT operand), ICAM places the message on the intercept queue. 
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In addition, if you have a message processing (MPPS) routine in your 
network, this is the name of the alternate destination (ALTD) your MPPS 
routine may refer to ina DIRECT, REROUTI, or REROUTO macro. 


If the terminal is marked down during the actual output processing of a 
given message, the ALTD param on the TERM macro will not be referenced 
at this time by ICAM, unless the MPPS REROUTO with ALTD operand is 
executed. 


Notes: 


I. Alternate destinations (ALTD) must not form a loop (terminals 
designating each other as alternatives); otherwise, system looping can 
occur. 


2. ALTD cannot redirect multiple destination messages queued in main 
storage. However, any multiple destination message going to all disk 
queues may be redirected. 


3. ALTD cannot be specified for a remote workstation. 
ANSWER=Cinteger,C, text) 


Specifies a site identification constant that ICAM can use to verify site 
identifier codes (site IDs) for 1004, 9200, or 9300 systems. 





integer 
Indicates the number of bytes represented by the third suboperand 
(text). 


Indicates the text suboperand consists of printable characters. 


text 
Is the alphanumeric site identifier. The number of characters you 
specify must be the same as specified in the integer suboperand. 


AUX 1=(aux-dev-id){£,...,AUX44=(aux-dev-id)] 
The AUXn operands specify device addresses (dids) for auxiliary devices 
connected to this terminal. All terminals associated with ICAM include at 
least one input and/or output device, which is considered the primary device 
for I/O operations. You do not specify this operand for these primary devices. 
However, in addition to the primary device, a terminal may also support a 
number of secondary devices, known as auxiliary devices. You use this 
operand to identify these auxiliary devices. 


Note: To use terminal spooling, you must have a dual-screen terminal 
defined as two terminals: one primary and one secondary. The AUX 
operand must be specified on both TERM definitions. 
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AUX1 through AUX44 create a displacement table of dids for auxiliary 
devices connected to this terminal. In your communications user program, 
use the n value of the AUXn operand in the device field (TM#DDVC) of a 
destination DTFCP when you issue a PUTCP request to send a message to 
an auxiliary device. In addition, the n value is placed in the TM#PDVC field 
of an input DTFCP by ICAM to indicate the auxiliary device that sent the 
message when you access a message by means of a GETCP. 


You must specify the AUXn operands in sequential order, for example, from 
AUX1 to AUX12 (if 12 are necessary). The exception is when you specify the 
tape drives on a tape cassette system. Each device requires two dids, but 
you only specify one n, even though two are used. For example, for a tape 
drive, you might specify AUX1=(TCS,73,74). The second drive would be 
defined as AUX3=(TCS,75,76). Notice that AUX2 was not specified, and that 
the next available AUXn is 5. 


How you define the auxiliary devices on your terminals depends upon the 
kind of terminal you have. The following describes how you specify the 
possible device addresses for each type of a supported by ICAM. 


¢ U200, UTS 400/20/30/40, PC with STEP, SVT 1120/1123/1124 
! 


The primary input/output devices are tha keyboard and printer. The 
allowable range for auxiliary device addresses is 734, to TE 46; (7046, 
71,45, 724, and 7F,, are reserved). The afta device addresses 
20,, to 6F,, may be specified to designata auxiliary devices attached to 
a UTS 4000 terminal. 


The device address of the auxiliary printer connected to the SVT 1120, 
SVT 1123, or SVT 1124 is 7345. 


The AUXn operand is used as follows: 


For printers: 


AUXn=(} COP | ,did) 
cap 


TP 


where: 

COP 
Identifies the communications output printer or the 0786, 
0797, or 0798 printer subsystem. 

cap 
Identifies the 0791 correspondence quality printer subsystem. 

1P 
Identifies the 800 terminal printer only. 

did 
Specifies two hexadecimal digits giving the device address in 
the printer. 
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For diskette or tape cassette: 


AUXN=(TCS, didy, did») 
Identifies one of the two cassette drives (n) on the cassette 
subsystem, regardless of the type of operation (n + 1 is also 
valid except for write operations). 


TCs 
Identifies a tape cassette system (TCS) or diskette 
subsystem for the UTS 400 or UNISCOPE, or a diskette 
for the UTS 4000. 

did, 

Specifies two hexadecimal digits giving the output device 
(write) address in the TCS for one of the two drives. 
did 
: Specifies two hexadecimal digits giving the input device 
(read) address in the TCS for the same drive. 


Note: Diskette or tape cassette subsystems are not supported for remote 
workstations. 


The following example shows a network definition that supports a UTS 

400 terminal. As you can see in the TERM macro definition, the UTS 

400 terminal supports two COP printers and two tape cassette systems @ 
(4 drives). Note how each AUXn parameter relates to the number of 

dids specified. 
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u400 CCA TYPE=(STDMCP) , CCAID=U400 
BUFFERS 16,64,2,ARP=40 

LNO1 LINE DEVICE=(UNISCOPE) , TYPE=(960, SYNC) , ID=8, x 
LBL=64, INPUT=YES 

™O1 TERM FEATURES=(U40@, 192), HIGH=MAIN,MEDIUM=MAIN, LOW=MAIN, X 
ADDR=(21,54) ,AUX1=(COP,73) , AUX2=(COP, 74), 
AUX3=(TCS, 75,76) ,AUXS=(TCS,77,78), x 
AUX7=(TCS,79, 7A) , AUX9=(TCS, 78, 7C) 

PRF1 PRCS LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
ENDCCA 


x< 
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DCT 500, DCT 524, DCT 475, and TTY 


In addition to the primary input and output devices of the keyboard and 
the printer, the DCT 500, DCT 475, and TTY supply auxiliary device 
support for the paper tape reader and punch. The DCT 524 supplies 
auxiliary device support for the write and read cassette systems. 


AUXn=([ PTP 
PTR |) 


where: 


PTP 


Identifies the paper tape punch or the cassette write head for 
the DCT 524. 
PTR 


Identifies the paper tape reader or the cassette read head for 
the DCT 524. 


The following values are substituted for the designated parameters: 


Device Device Address (Hex.) 
Parameter Wired in DCT 500 
PTP 75 

PTR 76 


DCT 2000, 1004 card processor, and 9200 and 9300 systems 
The primary input and output devices for the DCT 2000 and the 1004 
card processor are the card reader and page printer. In addition, the 
DCT 2000, the 1004 card processor, the 9200 system, and the 9300 
system provide auxiliary device support for a single card punch. 
For these systems, the AUXn parameter is: 

AUX1=(PCH) 


where: 


PCH 
Identifies the card punch. 
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¢ UTS 40D (model ID and UTS 40D and SVT 1122 local 
workstations 


You may specify up to four printers (PRNTR) attached to a UTS 40D, 
but only one printer (PRNTR) attached to an SVT 1122. 


AUXn=(PRNTR) 


where: 


Is1 to 4. 
Notes: 
1. You may not specify auxiliary printers for UTS 20D local workstations. 
2. Fora printer attached toa UTS 40D or SVT 1122 local workstation, wait 
60 seconds after input for notification of start of printing (timeout) before 


checking on the printer. 


8. For OS/3 to MAPPER 5 connectivity, only auxiliary printers are 
supported for the AUXn operand. 





4. For dual-screen local workstation devices, printing is done through the 
second screen. Printing cannot occur if the second screen is already 
allocated to ICAM (that is, a session is established between the screen 2 
TERM and another end user. 


CALL=phone-number 
Specifies a numeric or alphanumeric telephone number used to dial a data 
terminal equipment (DTE) on a DATEX-L public data network. 


DESPACE= 
Specifies the action to be taken by ICAM or interactive services for loading 
the destructive space specification of the control page. This parameter 
applies only to remote workstations, UNISCOPE terminals, and 
UNISCOPE-like devices attached to a DCP. 


DESPACE=U 
The destructive space parameter is not to be altered (that is, it remains 
set as previously specified in the control page). This is the default 
value. 


DESPACE=Y 


The destructive space parameter is set each time ICAM or interactive 
services loads the control page. 
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DESPACE=N 
The nondestructive space parameter is set each time ICAM or 
interactive services loads the control page. 


Notes: 


1. The DESPACE parameter on the TERM macro overrides the DESPACE 
parameter on the LINE and CCA macros for this terminal only. 


2. The ICAM destructive space definition is restricted for use by terminals 
located on a cluster controller, which are not loaded with the correct 
ICAM gen specification for DESPACE=U/Y/N. To obtain the desired 
destructive space setting, you must manually change the control page 
specification or use the interactive services SCREEN command. 


pice=(f GW ),f | 
OFF, | FORMS 


Describes how you want device independent control expressions (DICE) used 
with this terminal. If you do not specify this operand, 
DICE=(ON,NEWLINE) is assumed. 





ON 
Indicates that the ICAM remote device handler places DICE into all 
input messages. 


OFF 
Indicates that DICE characters are not placed in input messages. 


NEWCINE 
Indicates that on output, a set coordinates or a forms control with clear 
DICE is converted to a new line positional control DICE with the DICE 
m field equal to 00,, and the n field equal to 00,,. 


FORMS 


Indicates that on output, a set coordinates DICE is converted to a forms 
control DICE. 
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Notes: 


1, NEWLINE and FORMS apply to all devices except cathode ray tube 
devices and the COBOL message control system (CMCS). NEWLINE is 
always assumed for the IBM 3270 terminal system since the IBM 
8284/3286 printers do not have a form-feed function. 


2. You must specify DICE=(ON) when using the COBOL message control 
system. 


3. You must specify DICE=(OFF) when you use FEATURES=(TTYEM) on 
the TERM macro. 


DISIN=n 
This operand applies only to DATEX-L circuit-switched public data 
networks. Specifies the time, in poll interval periods, that a terminal 
remains connected to the network after a message is received (see PINTV 
keyword). If omitted, the terminal is disconnected immediately after the 
completed message is received and acknowledged. 


DISOUT=n 
This operand applies only to DATEX-L circuit-switched public data 
networks. Specifies the time, in poll interval periods, that a terminal 
remains connected to the network after a message is transmitted. If 
omitted, the terminal is disconnected from the network immediately after 
the message is transmitted and acknowledged. 


DVCGID=terminal -group-name 
Specifies the name of a remote terminal group in a DCA multinode or Telcon 
environment. The DVCGID operand must be one of the following names: 


Interactive Terminals: INT33 for UNISCOPE 
INT41 for UTS 400 
INT51 for all others 


INHIBIT=YES 
Indicates ICAM is to ignore all subsequent input from this terminal 
following successful input of a message. This inhibition remains in force 
until a successful output transmission is completed. Any messages sent from 
this terminal following the first successful one are lost. This allows you to 
set up an inquiry/response relationship with this terminal; that is, one 
message is followed by a single response. 


INONLY=YES 


Specifies that this terminal is a send-only device; that is, traffic always flows 
from the terminal to ICAM. 
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sai | name |! ,blanksIJ[, filename]) 
YES 


Establishes a destination for messages input at this terminal. 


Note: You must specify the INPUT operand for each terminal on a line - 


name 


YES 


either here or in a LINE macro for the line to which this terminal is 
connected. If you specify this operand in both the LINE and the 
TERM macros, the TERM destination is used. 


Is al- to 4-character name that matches the label of a LOCAP, PRCS, 
MPPS, or TERM macro. This is the name you address on GETCP calls 
to a process file or a LOCAP file to retrieve input messages from this 
terminal. Depending on the name you specify, input messages from this 
terminal are directed to: 


¢ the low priority queue of a communications user program defined 
by the label of a LOCAP macro (global networks only) 


e the low priority queue of a process file, defined by the label of a 
PRCS macro 


¢ the low priority queue of a terminal, defined by the label of a 
TERM macro (this causes message switching because a message, 
input from a terminal on this line, is immediately placed on the 
output queue of another terminal) 


¢ adestination determined by MPPS, with the name of the routine 
defined by the label of an MPPS macro. This is the only 
destination you may specify for the transaction control interface. 


Creates an input message queue for this terminal. If you also include 
the filename suboperand, input messages are held in a disk file until 
your program accesses them. If you omit the filename, a main storage 
input message queue is established. Your program accesses a message 
placed on this input message queue by issuing a GETCP macro, and in 
the related DTFCP, specifying the name of this TERM macro. You do 
not need to specify a priority. 


Use INPUT=YES when you specify FEATURES=(TTYEM) on the 
TERM macro. 


blanks 


Is a decimal value from 1 to 255 that indicates the number of bytes 
(blank characters) you want reserved in front of each input message for 
MPPS or your program’s insertion of data. 
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filename 
Is al- to 7-character name of a disk file where messages input from this 
terminal are stored until your program accesses them. The filename 
must match the label of a DISCFILE macro. Include this suboperand 
only if you also specify YES. 


INRECSZ=( &@ 
96 


128 
Specifies the input record size for a batch terminal in bytes. It is valid only 
for the following devices: 


¢ Unisys DCT 2000, 1004 (REM1), 9200, 9300 (REM1), BSC 
e IBM 2780, IBM 3780, UNIX O/S emulating an IBM 2780 or 3780 


Note: The INRECSZ operand must not be used in conjunction with the 
REMOTE operand. 


filename 
YES creates a main storage intercept queue for output messages for this @ 
terminal when you use line queueing for output messages. If you specify 
filename, the intercept queue is placed on a disk file you identify by means of 
the label of a DISCFILE macro. The intercept queue can be used by ICAM 
or by a message processing routine to temporarily store messages. If you 
have a message processing routine, and it detects an error in an output 
message to this terminal (such as a bad destination), it can send the message 
to this intercept queue where it is held until your program releases the 
intercept queue by means of a RELEASM macro. 


aes YES 


Both ICAM and your message processing routine can send messages to an 
intercept queue for line/terminal-down situations, if you don’t have an 
alternate destination specified (see ALTD operand). However, when the 
destination terminal becomes operable, ICAM automatically releases any 
messages held on the intercept queue. If you do not specify this operand, an 
intercept queue is not created for this terminal. 


Notes: 


1, Multiple destination messages can be redirected to an intercept queue 
only if they are on disk. 


2. You must specify line queueing to use this feature. 
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LOW, MEDIUM, and HIGH 


These operands create priority terminal output queues in main storage or on 
disk for this terminal. They override any you create by means of the LOW, 
MEDIUM, and HIGH operands in the LINE macro. 


LOW=f i lename 


Creates a low priority output queue for this terminal on a disk file you 
name in a DISCFILE macro. 


LOW=MAIN 
Creates a low priority output queue for this terminal in main storage. 


MEDIUM=f i lename 


Creates a medium priority output queue for this terminal on a disk file 
you name in a DISCFILE macro. 


MEDIUM=MAIN 


Creates a medium priority output queue for this terminal in main 
storage. 


Note: If this operand is omitted, a medium priority queue is not created. 


HIGH=f ilename 


Creates a high priority output queue for this terminal on a disk file you 
name in a DISCFILE macro. 


HIGH=MAIN 
Creates a high priority output queue for this terminal in main storage. 


Note: If this operand is omitted, a high priority queue is not created. 


MSGWAI T=(message) 
Defines a 4-character computer message waiting message that is sent to this 
terminal to inform the terminal operator of a waiting message. The terminal 
operator must respond with BEL (control G) and ETX (control C) before the 


waiting message is sent to the terminal. It is ignored for IBM 3270 
terminals. 


This operand is only used with DCT 475, DCT 500, DCT 524, or TTY 
terminals. It is ignored for IBM 3270 terminals. 


If you do not specify this operand, the message /CMW is used, but you can 
specify any 4-character message. 
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Note: No carriage return or line feed characters accompany the default 
message. However, they can be inserted as the first or last two 
characters of the 4-character message operand, leaving two printable 
characters in the message. This can be accomplished by 
multipunching carriage return (0-9-5) and line feed (12-9-8-5) or by 
multipunching a DICE expression with a DLE (12-11-9-8-1) and the 
function code for new line (4). In either situation, the remote device 
handler inserts appropriate time fill for carriage return and line feed. 


OUTONLY=YES 
Specifies that this terminal is a receive-only device; that is, traffic always 
flows from ICAM to the terminal. 


PINTV=tenths-of-seconds 
Is the time in tenths-of-seconds between polls to this terminal. You may 
specify a value from 1 to 2550 (1/10 second to 255 seconds). This operand 
applies to UNISCOPE 100/200 and UTS 400/4000 terminals and IBM 3270 
terminal system. If you use polling groups, only the time specified for the 
first terminal in the polling group is used; if you specify PINTV for a 
subsequent terminal in the same polling group, this operand is ignored. 


A polling timer is established for each terminal or group of terminals (that is, 
a polling group) in a network definition. Each of these polling timers is 
incremented at a fixed interval. This interval is 0.1, 0.2, 0.5, or 1 second 
depending on the smallest interval you specify for any terminalinthe . 
network. 





For example, if you define a network of two terminals and specify PINTV=50 
for the first terminal and PINTV=58 for the second, the first terminal is 
polled every 5 seconds and the second every 6 seconds. This is because the 
basic timer interval is 1 second and the 5.3-second specification (PINTV=53) 
is rounded to 6 seconds. If, however, you added a third terminal to the 
network to be polled every 0.1 second (PINTV=1), the basic timer interval 
would be 0.1 second and all three terminals would be polled as specified; that 
is, 5, 5.3, and 0.1 second intervals, respectively. 


If you specify the smallest PINTV value and make a syntax error (such as 
specifying an alphabetic character), system generation displays the message 
INVALID PARAMETER VALUE. However, if you specify the smallest 
PINTV value as an invalid number (for example, PINTV=3), no error 
message is displayed. In both cases, a polling increment of 1 second is used. 
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PLIMIT=integer 
Is the maximum number of messages to be accepted from this terminal in a 
single polling pass. If you omit this parameter, all messages ready for 
transmission are accepted. This operand is used for polled terminals 
serviced by a remote device handler you write yourself. Do not specify this 
operand if you are using a remote device handler supplied by Unisys. 


PROFIL=n 
Assigns a profile number used with the message format editing facility. The 
number you assign must agree with one you assign in an EUP macro by 
means of its PRFN operand. 


Note: If you use the same editing profile for several terminals, you must 
specify multiple EUP macros and assign a different PRFN number to 
each. You cannot specify the same physical profile to more than one 
terminal. 


PROTYP=[ DEV 
INT-1 


RB-2 
Describes how data is presented by the terminal. DEV specifies device 
dependent for terminals attached to a remote OS/3 host. INT-1 and RB-2 
specify interactive or batch terminals respectively attached to a distributed 
communications processor. 


PSEUDO=tel con- term- name 
Matches the terminal name specified in a Telcon generation where the 
terminal name is greater than 4 characters but less than or equal to 8 
characters. Do not use this keyword if only 4 characters are used, as it would 
only create more processing. 


RBATCH=[ NO 
YES 


Indicates that this terminal is used for remote batch jobs. If omitted, 
interactive is assumed. When RBATCH=YES is specified, the operand 
XLATE=(NO,NO) must be specified if the batch terminals are attached to a 
distributed communications processor. 


REMOTE=(node- id) 
Specifies the remote node to which this terminal is connected. This operand 
is a 1- to 4-character name that must be the same as the destination node 
specified in the LPORT statement. 
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REMOTE=(subname, PDN, [PT1) 
For packet-switched public data networks only, specifies that this is either a 
terminal attached to a remote host or a workstation attached to a UTS 4000 
series packet-switched cluster controller. 


Terminals or workstations in these categories must be defined with their 
TERM macros following the SUB macro defining their common subscriber. 


subname 
Specifies the symbolic name of the SUB macro that defines the remote 
host or cluster controller for this terminal or workstation. 

PDN 
Specifies that this is a public data network user. 

PT 
Specifies that this terminal is a workstation attached to a cluster 
controller. This operand is not used for terminals attached to a remote 
host. 


SCREENS=( | [ n 
s [,subtype]) 


n 
Specifies the number of screens that are supported by this "master" 
terminal, including the master terminal screen. If no extra screens are 
supported by this TERM macro, omit this keyword and a default value 
of 1 will be assumed. 


Specifies this terminal is a screen supported by a master terminal. 
Each supported screen must have its own TERM macro. 


Note: The purpose of this keyword is to mark down all the terminals 
supported by the "master" terminal (including the master) when any 
one of them is marked down. When any one of these terminals is 
marked up, they all will be marked up. For example, assume a 
terminal has been configured to support three screens: 


1 72 
TRM1 TERM FEATURES=(U20, 1920), X 
ADDR=(28,51), x 


SCREENS=(3),... 


TRM2 TERM  FEATURES=(U2@, 1920), x 
ADDR=(28,52), x 
SCREENS=(S),... 


TRM3 TERM = FEATURES=(U20, 1928), x 


ADDR=(28,53), X 
SCREENS=(S),... 
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subtype 
This parameter lets you define the true device type specified by the 
generic U20/U40 specification within the FEATURES= parameter. This 
may allow ICAM users to take advantage of additional functionality. 
(This information will be made available with the TCI interface.) If you 
do not specify a subtype, the terminal is treated as a true U20 or U40 
device. 


This parameter may be specified for terminals on a UNISCOPE, RWS, 
DCPCHNL, or VLINE. Valid subtypes are: 


1120, 1123, 1124 
PC 

OFIS 

UNIX 

UTS30, UTS60 
VIPS 


Note: The OFIS subtype specifies an OFIS® Link system. 


SPR=[ 68 
seconds 


Specifies the slow polling interval for a downed polling group in seconds. 

Specify a value from 1-3000. If not specified, a default value of 60 is used. 
This operand applies to UNISCOPE and IBM 3270 (FEATURES=(3271)) 
lines only, and need only be specified on the first terminal in each polling 


group. 


TCTUPD=YES 
Specifies this UNISCOPE terminal can communicate with OS/3 interactive 
services and another program such as IMS or a user-written program when 
signed on ($$SON) to dynamic sessions (a LOCAP macro specified as 
TYPE=DM)). 


Do not specify this operand if this macro defines a local or remote 
workstation. 


This operand controls the DICE status and translation tables used between 
this terminal and interactive services. If you specify TCTUPD=YES, ICAM 
uses the proper DICE status and translation tables when you sign on to 
interactive services. When you sign on to your user program or IMS, ICAM 
uses the DICE status and translation tables you specify in the DICE= and 
XLATE= operands. 


OFIS is a registered trademark of Unisys Corporation. 
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TIMEFILL=NO 
Specifies that no time fill characters will be inserted into an output message 
after FCC or ESC sequences. If this parameter is omitted, time fill 
characters are inserted for these sequences according to the line speed. This 
parameter applies only to remote workstations and UNISCOPE terminals. 


XLATE=(1[ YES | ES 
NO NO 
labeli, idi labelo,ido | |) 


The XLATE operand lets you specify the translation table you want to use 
for input from this terminal and also the one you want to use for output 
going to this terminal. You can write your own translation tables, use those 
supplied by ICAM, or specify that you want no translation at all. If you omit 
this operand entirely, the translation tables established for this line, by 
means of the LINE macro, are used. (For a discussion of how to generate 
translation tables, see Section 4.) 


For IBM 3270 terminal systems or local workstations with Katakana 
support, specify XLATE=(NO,NO). See DEVICE=(LWS,KA) in the LINE 
macro. : 





For a TTYEM device, specify XLATE=(NO,NO). 


The XLATE operand is divided into two similar suboperands; the first 
suboperand is concerned with input translation, and the second is concerned 
with output translation. 


Input translation is specified as: 


YES 
Indicates that the standard translation table is used for input from this 
terminal. 


NO 
Indicates that no translation takes place for input received from this 
terminal. 


labeli 
Specifies the name of a user-supplied input translation table. The name 
specified must correspond to that specified for a user-generated 
translation table assembled in this network. 
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idi 
Is a decimal number, 1 to 240, identifying a user-generated input 
translation table within this network. This number makes it easy for 
ICAM to tell whether the same input translation table already exists in 
the network. If the same number is used with a different labeli name, 
the table name used is the last one specified. The same input 
translation table may be identified in any number of LINE or TERM 
macros. 


The default is the input translation table defined for this line (by means of 
the LINE macro) with which this terminal is associated. 


Output translation is specified as: 


YES 
Indicates that the standard translation table is used for output to this 
terminal. 


NO 
Means that output to this terminal is not translated. 


labelo 
Same as Jabeli but specifies the name of a user-supplied output 
translation table for this terminal. 


ido 
Same as idi but for the user-generated output translation table 
speicifed by labelo. 


The default is the output translation table defined for this line (by means of 
the LINE macro) with which this terminal is associated. 


Notes: 


J. 


The XLATE operand specified by means of the LINE macro is used for all 
terminals on this line for which an XLATE operand is not specified. If you 
specify an XLATE operand in this macro, it overrides the line information for 
this terminal only. 


The idi and ido suboperands refer to separate input and output translation 
tables; that is, you may specify up to 240 input translation tables and 240 
output translation tables. 


You include any translation tables of your own at the end of your network 
definition before the ENDCCA macro. 


Continuation of assembler DC statements is not acceptable; therefore, each DC 
statement should have a closing apostrophe in column 71 or before. 


Standard translation tables are either 128 or 256 bytes long; your tables 
should normally be one of these two lengths. 
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How to Define a Trunk in a Packet-Switched Public 
Data Network (TRUNK) 


This macro declares the name and attributes of the logical link between a packet- 
switched public data network (the data circuit-terminating equipment (DCE)).and the 
local subscriber (the data terminal equipment (DTE)). You may specify multiple 
trunks; however, each trunk must have a unique call number (DTE address). You 
determine the number of trunks you need when you subscribe to the PDN. 


The TRUNK macro must follow the PDN macro in your network definition. 


Table 2-28 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
symbol CALLNO=dte- address 


eas | | 


| 
a 
au 
mel 
a 


WS=window-size] 
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Table 2-28. Applicability of TRUNK Macro and Its Operands 


ar ICAM Network Type and Kind of Program Supported 


Operand Direct 
Name Data 
Interface 


Dedicated 
DD! Networks 


Global Networks 


NTR 





a 
ro} 
RBP a a“ 8 a: a 2 a 
RPG s/j/o;Oo] ols ra) : 
= 2 Oo 2 = 23 
B/E |g) a] s a8 
OES s a 
oO 
* TRUNK 
label R 
CALLNO= R 
@ DATATIM= O 
ljOSVC= Oo 
ISVC= Oo 
OSVC= O 
PVC= oO 
O 
*Shows macro applicability tPacket-switched only. 
LEGEND: 
R = Required O = Optional - = Not Applicable 
Label 
symbol 


Is al- to 4-character label used to reference this macro. 
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Operands 


CALLNO=dte- address 
Specifies the level 3 DTE address of the local subscriber. You obtain this 
information from the PDN at subscription time. Note that this is not the 
DTE address of the remote subscriber defined in the SUB macro. 


DATATIM=[ n_ 
10 
Specifies the level 3 timeout value in seconds for a data packet. Valid values 
are 1 to 120 seconds for all public data networks. 


IOSVC=[ n 
i) 


Specifies the number of switched virtual circuits that have the capability to 
receive incoming calls from a remote subscriber and also have the capability 
to send outgoing calls to remote subscribers. You determine this value at 
subscription time. 


Valid values for this operand are 0-4095 for all networks except DDX and 
PSS. The IOSVC operand is not valid for the DDX or PSS network. 


ISVC=[ n 
Q 
Specifies the number of incoming switched virtual circuits to receive 
incoming calls only. You determine this value at subscription time. 


Valid values for this operand are 0-4095 for all networks except DDX and 
PSS. The ISVC operand is not valid for the DDX and PSS networks. 


osvC=/ n 

Q : 
Specifies the number of switched virtual circuits that are used to make 
outgoing calls only. You determine this value at subscription time. 


Valid values for this operand are 0-4095 for all networks except DDX and 
PSS. The OSVC operand is not valid for the DDX or PSS network. 


PVC=[ n 
i) 
Specifies the number of permanent virtual circuits provided by the PDN at 
subscription time. This number must agree with the number of PVC macros 
you specify for this trunk and the number of permanent virtual circuits that 
can handle data assigned at subscription time. 
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Valid values for the PVC operand are 0-4095; however, for DATAPAC, 
DATEX, and IBERPAC, do not include logical channel 0 in the count. 
Although channel 0 is provided in these networks, it is used for control 
purposes only and is not usable for data. The PVC operand is not valid for 
the DDX and PSS networks. 


WS=window-size 
Specifies the level 3 window size for flow control of both input and output 
data packets. It applies to both switched and permanent virtual circuits on 
this trunk. Specify a value of 1 to 6 for TRANSPAC, DATAPAC, or DATEX- 
P. The WS operand is not used for DDX, IBERPAC, and PSS. Default 


values are as follows: 


DATAPAC 4 
DATEX-P 4 
DDX not used 
IBERPAC not used 
PSS not used 
TRANSPAC 2 
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2.27. How to Define a Virtual Circuit Group in a DDX or 
PSS Packet-Switched Public Data Network 
(VCGROUP) 


This macro defines the attributes of a permanent or switched virtual circuit group on a 
DDX or PSS packet-switched PDN for the most recently defined TRUNK macro. 


Table 2-29 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands), 


Format 








LABEL AOPERATIONA OPERAND 











symbol VCGROUP LCGN=group-number 
,NUMBER=n 
,TYPE=[ PVC 
ISVC 
OSVC 
1osvc 
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Table 2-29. Applicability of VCGROUP Macro and Its Operands 


Macro: ‘: 
ICAM Network T and Kind of Program Supported 
VCGROUP ‘s . hs 9 sis 


Operand ca 
Name ca 
Interface 


Dedicated Global Networks 
Networks 





a 
a ° am, 
a ao}; Q];al @ 4 £ 
s o;o};}ojys at 
= FS og = = 23 
— wn — a o 
Plalel/a {ke ez 
2 = 
oO 
*VCGROUP 
label 
LCGN= 
TYPE = 
NUMBER = 
*Shows macro applicability tDDX and PSS only 
LEGEND: 
R = Required O = Optional - = Not applicable 
Label 
symbol 


Is a required 1- to 4-character label used to reference this macro. 


Operands 


LCGN=group-number 
Specifies the logical channel group number of this group. 


For DDX you must specify a value of 0 to 15. 


For PSS you can specify a value of 0 to 7 depending on circuit type: 


PVC 0,1 
SVC (IN) 2,3 
SVC (1/0) 4,5 
SVC (OUT) 6,7 
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NUMBER=n 


Specifies the number of virtual circuits in this logical channel group. Never 
specify zero. Valid values are 1-255. 


TYPE= 
Specifies the composition of a logical channel group. 


TYPE=PVC 
Specifies this logical channel group is composed of permanent virtual 
circuits only. 


TYPE=ISVC 
Specifies this logical channel group is composed of incoming switched 
virtual circuits only. 


TYPE=OSVC 
Specifies this logical channel group is composed of outgoing switched 
virtual circuits only. 


TYPE=IOSVC 


Specifies this logical channel group is composed of switched virtual 
circuits that can handle both incoming and outgoing calls. 
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2.28. How to Specify Virtual Channels (VLINE) 


The VLINE macro specifies the physical link that connects two computer nodes in a 
global network system. In a PDN environment it defines the physical line that 
connects the data terminal equipment (DTE) and the data terminal communications 
equipment (DCE). 


VLINE is used with DCA multinode, Telcon or UNIX file transfer, or public data 
networks. It is not used in dedicated network definitions or global network definitions 
where the end users reside in the same computer node. 


Note: You must specify all resources that pertain to a particular VLINE before 
you define any additional VLINEs. 


Table 2-30 describes the interface and type of network definition in which you may 
use this macro. It also details the applicability of each operand in the macro. The 
first line in the table is the name of the macro itself preceded by an asterisk (to 
distinguish it from its operands). 


Format 
LABEL AOPERATIONA OPERAND 
symbol 1D=slca-number 
,DEVICE={ ABM 
LAPA 
LAPB 
(NRM) 


{, CHAN=channel - number J 


=o) 


at value i 
bo 








,size, threshold } | 
) 


N 


ea 





continued 
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LABEL AOPERATIONA OPERAND 


i 
emt) 
bag 9 


symbol VLINE (cont.) 





1) £,UNATI) 
ED 
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Table 2-30. Applicability of VLINE Macro and Its Operands 


vane ICAM Network Type and Kind of Program Supported 


Operand ca 
Name ca 
interface ; 
oated Global Networks 
Networks 





a 
@lolSiala). s 
| 218)2/2 | 3 q 
Bye/sie)e| 8 3 
oO 
0 R 
as R R 
ID= a Oo 
CHAN= * fe) 
CMDADOR = - ce] Oo 
DEVICE = - R R 
Z ce) .e] 
LBUF = - (@) O 
RETRY = - fe) 0 
RSPADODR = - fe) ce] 
TIMEQUT = - O O 
TYPE= - 0 R 
*Shows macro applicability 
LEGEND: 
R = Required O = Optional - = Not applicable 
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Label 


symbol 
Is a 1- to 4-character required name of this physical link. It is also 
referenced by the LPORT macro. 


Operands 


ID=slca-number 
For System 80 models 3 through 6, the slca-number is specified as a number 
from 8 to 15 identifying the line number of the single line communications 
adapter (SLCA). 


For System 80 models 8 through 20, the slca-number can be from 1 to 15 for 
each input/output microprocessor (IOMP). 


DEVICE=| ABM 


LAPA 
LAPB 
(NRM) 

Specifies the type of protocol used on this physical link. 


ABM 
Specifies this line is used for communications between two OS/3 DCA 
termination systems in a distributed communications architecture data 
processing environment. This operand must be specified for circuit- 
switched PDNs. 


LAPA 
Specifies CCITT recommendation X.25 link access procedure A (LAPA) 
protocol is used on this line. This operand can only be used with the 
DATAPAC packet-switched public data network. 


LAPB 
Specifies CCITT recommendation X.25 link access procedure B (LAPB) 
protocol is used on this line, and this line is used with a DATAPAC, 
DATEX, DDX, IBERPAC, PSS, or TRANSPAC packet-switched PDN. 


(NRM) 
Specifies that the UDLC/NRM protocol is used. For the UNIX O/S file 
transfer capability, you must specify DEVICE=(NRM). 
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CHAN=channel -number 
Specifies the input/output microprocessor (IOMP) to which the single-line 
communications adapter (SLCA) is connected. 


For System 80 models 3 through 6, this operand is optional. If specified, the 
only value permitted is CHAN=2. Up to eight SLCAs (ID=8 to ID=15) can be 
specified. 


For System 80 models 8 through 20 with one IOMP, this operand is optional. 
If specified, the only value permitted is CHAN=13. Up to 14 SLCAs (ID=1 to 
ID=15) can be specified. 


For System 80 models 8 through 20 with two IOMPs, this operand is 
optional. If specified, you must also specify the ID= operand. The only 
values permitted are CHAN=13 and CHAN=15. Up to 14 SLCAs (ID=1 to 
ID=15) can be specified for each IOMP. 


CMDADDR=[ i 


n 
Is a decimal number from 1 to 255 specifying the universal data link control 
frame level address used to transmit commands and receive responses. The 
default value is 1. 


K=value 
Specifies the number of frames (K window value) that can be sent or received 
across this virtual link before an acknowledgment is required. You can 
specify a value of 1 to 7 subject to the following guidelines: 


¢ Ifyou specify DEVICE=ABM, you must specify K=1. 
e Ifyou specify DEVICE=LAPA or DEVICE=LAPB, specify K=7. 
¢ Ifyou specify DEVICE=NRM, do not specify a value for K. 
LBUF =(number ,size, threshold) 
Generates a buffer pool associated with this physical link. The operand 
defines the number of buffers created, the size of each buffer, and a 


threshold value. 


Note: Do not specify this operand if you specified DEVICE=ABM or 
DEVICE=(NRM). 


number 


Is a decimal value that specifies how many buffers are created. You 
must specify at least 19 buffers. 
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size 
Is the maximum number of words (4-byte words) of data that can be 
transferred across the virtual line within one information frame. ICAM 
breaks up user messages into segments that fit into the buffer size 
specified and places them into the buffers before transferring the data. 
The actual size of a buffer is the size specified, plus line protocol 
framing characters. 


threshold 
Is a decimal number of inactive VLINE buffers that you will allow. 
When this minimum is reached, ICAM ceases solicitation of further 
input until a safe level is reached. It is suggested that you specify a 
value 10 to 15 per cent of the numbers you specify for number. 


If you do not specify the LBUF operand, it defaults as LBUF=(19,64,1). 


RETRY=(n,m) 
Specifies the number of retries that the remote device handler is to attempt 
before an error message is sent to the operator. 


n 
Is a decimal value, from 1 to 255, that specifies the maximum number of 
times a command or data message is sent due to the lack of an 
acknowledgment. If an output message is not acknowledged, the 
remote device handler waits the time specified in the TIMEOUT 
operand and retransmits the message. This sequence of timing-out and 
retransmission continues until the value specified in this operand is 
satisfied; at this time, an error message is sent to the operator. 


Is a decimal value, from 1 to 255, that specifies the number of attempts 
the remote device handler makes to write a command, data, or response 
due to a hardware failure or a time-out. The remote device handler 
receives a report of whether the message was sent; if not, it retransmits 
the message until the value specified in this operand is reached. At this 
time, a message is sent to the computer operator. 


If you omit this operand, RETRY=(10,10) is assumed. 


RSPADDR=[ 3 
n 
Is a decimal number from 1 to 255 specifying the universal data link control 
frame level address used to transmit responses and receive commands. The 


default value is 3. 
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Notes: 


1. CMDADDR and RSPADDR are needed only when DEVICE=ABM is 
specified. 


2. When running multinode, the CMDADDR value of A must equal the 
RSPADDR value of B, and the RSPADDR value of A must equal the 
CMDADDR value of B. 


3. When running Telcon, the CMDADDR value must equal the LSA value in the 
STATION statement in the Telcon generation, and the RSPADDR value must 
equal the RSA value. 


TIMEOUT=(n,m) 
Specifies the time-out period the ICAM remote device handler is to wait for a 
response to an output message and the maximum time it is to allow for a line 
buffer to empty or terminate. 


n 


Is the maximum time in seconds (1 to 32000) that the ICAM remote 
device handler is to wait for an acknowledgment before retransmitting 
the data message or command, (See RETRY.) 


Is the maximum time in seconds (1 to 32000) to empty or terminate a 
line buffer. 


If this operand is not specified, it defaults to: TIMEOUT=(4,20). 


mer 


Line-speed ],[ X21 
9600 aa 





~ 


_ jef sHCH 
pave || Leases 


} L,UNAT]) 


Line-speed 


Specifies the rate (baud) at which data is transferred between two 
computers described in this macro. Line speed is a function of the 
modems used. Acceptable values are: 2400, 4800, 9600, 19200, 48000, 
and 56000. 


For SLCA3 connections, the maximum line speed is 9600 baud (full 
duplex); for SLCA5 connections the maximum line speed is 56KB (full 
duplex). 


For PDNs, acceptable values are 2400, 4800, and 9600 (packet- 


switched); 600, 2400, 4800, and 9600 (circuit-switched). For an NRM 
dedicated line, the value must not exceed 4800. 
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Specifies a CCITT X.21 interface between the data terminal equipment 
(DTE) and the data circuit terminating equipment (DCE). This operand 
must be specified for all circuit-switched networks and for DATEX-P 
networks using X.21 leased lines. 


RS232C 
Specifies an EIA RS-232-C interface between the data terminal 
equipment (DTE) and the data circuit terminating equipment (DCE). 
This operand is valid for packet-switched networks only. 


SWCH 
Specifies that the line must be dialed by the operator. This suboperand 
is not supported if DEVICE=ABM. 





SED 
Specifies this virtual line is leased; i.e., a private line. This operand 
must be specified for packet-switched PDNs. 


UNAT 
Specifies this line is in unattended answering mode of operation. This 
suboperand is not needed if DEVICE=ABM. 
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Section 3 
Defining Your Network 


3.1. 


How to Prepare Your Network Definition 


Before you write an ICAM network definition, be sure to understand the overall 
structure of your computer’s communications network. Also, you must be able to 


define: 


¢ ICAM end users (such as terminals, LOCAP files, and process files) 
e Session paths between end users, including lines and ports 
¢ ICAM interfaces (such as STDMCP, TCI, and DMI) 


¢ ICAM network types (dedicated or global) 


All of the available network types are discussed in this section, with sample network 


definitions covering many applications. Table 3-1 lists the macros described in 
Section 2 and indicates each applicable type of network definition. Table 3-2 
highlights the important macros and operands for each type of network definition. 
These tables will help you prepare your own network definitions. 
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Macro 
Name 


BUFFERS 


CGRPEND 
CONGRP 


DCPCHNL 


DISCFILE 
Buffering 








Table 3-1. Macro Usage by Network Definition Type 





Global Networks 





Dedicated 
Networks 










Main Use 










STDMCP** 


TCI (IMS) 








Establishes network and activity request packet 


Identifies the beginning of a network, ICAM features, 
journaling requirements, etc. 


Indicates the end of a UDLC/NRM configuration group 
definition 














Defines a group of stations connected to a particular 
line (VLINE) when using NRM line control 






Indicates status of a circuit-switched public data 


Specifies DCP channel characteristics 

















er a ee 
po [Tol [Tete [7a [= feca 





DISCFILE 

Queuing 

DISCFILE Defines a disk file for use by ICAM 
DLIST 


Cees OS De a 
pol={ of =]i ff if [a] = [revs 
Fes ES ee 
ete ae el, 


& Creates a list of destinations in your network 
a | Indicates the end of a network definition 







ENDCCA 


JRNFILE 


LDTE g 








Formats output messages to terminals 
Defines a journal file 


Defines attributes of a local data terminal equipment 

in a circuit-switched public data network 

Establishes the characteristics of each line in a 
communications network 


Creates a locap file for user programs that use global 
networks 





LINE 
LOCAP 
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Table 3-1. Macro Usage by Network Definition Type (cont.) 


: Global Networks 


Dedicate 
Network Public 
Data 


sTpmce** 
STDMCP** 
TCI (IMS) 


Defines a circuit-switched or packet-switched public 
data network 


Specifies a poll group for remote workstations 


Defines a process file for eee or ee ane meres Y storage of 
eee or ee ane meres Y 


Defines a permanent virtual circuit on a packet- 
switched public data network 


Defines attributes of a remote data terminal equipment 
in a Circuit-switched public data network 


SESSION | -]-]-]ofo]-]-] 0 ]o Joerines a stac session ina global nework | Defines a static session in a Defines a static session in 9 global network | network 


STATION Defines the unique characteristics of a station (required 
by the NRM link level control) 


Defines a remote ‘subscriber on a packet-switched 
public data network 


TERM Mm Eeesetiad Se Defines the characteristics of each terminal 
TRUNK Defines a trunk on a packet-switched public data 
network 


VCGROUP Defines a virtual circuit group on a packet-switched 
public data network 





| 
* Includes NTR and RBP network definitions. 
** Legend in parentheses is for COBOL (CMCS) applications. 


LEGEND: 
R = Required 
oO = Optional 


i 


Not applicable 
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Table 3-2. OS/3 Basic Network Configurations 


CCA 
TYPE = (STOMCP) 


Single-Node Global } Standard | IS/DDP 


CCA 
TYPE = (GBL, node} {GBL, node) {GBL. node) 
(STOMCP} (TCl) (DMI) 
YES 

a ee Oe 
Standard 1s/DO0P 
Dynamic Dynamic Packet-Switched 
Sessions Sessions 
CCA 

TYPE = {GBL, node} (GBL,.node) (GBL, node) {GBL. node) {GBL, node) 

OCA= YES YES YES YES YES YES 

GAWAKE = YES YES YES 

LIME 


TERM 
FEATURES =(1) 
PROTYP = INT-1/R8-2/DEV INT-1/RB-2/DEV INT-1/RB-2/DEV 
RBATCH= 
DVCGID = 
REMOTE = node-id node-id node-id subname, PDN 


(TC) 
OICE 


ABP NTR 




















Multinode Global 













































































(STOMCP) (DMI) 
XPAREN 


(YES, OFF) 


(OMI) /(STOMCP)/ (OM)) /(STDMCP)/ 
(TC) XPARENT (TCl) XPARENT 

















PON 
CARRIER = 
TYPE = 


VLINE 
DEVICE = 
LPORT 
USERTP = STOMCP 












carrier-name 
CIRCUIT 


carrier-name 
PACKET 








continued 
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Table 3-2. OS/3 Basic Network Configurations (cont.) 


Notes: 


UP-9745 Rev. 3 


The DEVICE operand of the LINE macro and the FEATURES operand of the TERM macro define the protocol 
and device handlers to be incorporated for the specific terminals or workstations attached to each line. 


To use a local workstation with a user program, include the following operands: 


LINE DEVICE=(LWS) 

TERM FEATURES=(U2@) , ADDR=(dev- addr ) 
OR (U4@) 
OR (1122) 


To use an interactive terminal with interactive services, include the following operands (this lets an interactive 
terminal emulate a workstation). 


LOCAP TYPE=(DMI), IAS=(YES, OFF) 
LINE DEVICE=(UNISCOPE) 
TERM FEATURES=( . . . ),TCTUPD=YES 


To use a remote workstation with a user program, include the following operands: 


LOCAP = TYPE=(STDMCP) or (TCI) 

LOCAP  TYPE=(DMI) ,MODE=SYSTEM, IAS=(YES, OFF) 
LINE DEVICE=(RWS) 

PGROUP PGID=rid 

TERM FEATURES=(U4@)... 

TERM FEATURES=(U4Q)... 


The non-DMI LOCAP file is for workstation mode; the DMI LOCAP file is for interactive services. 


Remote workstations are grouped in poll groups. A PGROUP macro must precede each group of workstations 
in a poll group. 


Remote workstations with dual-screen capability require a TERM macro for each of the two screens. The 
FEATURES operand of the first TERM macro must specify the primary screen, and the other TERM macro 
specifies the secondary screen. 


When using interective terminals ina DCA/DCP environment, the TERM macro must specify PROTYP=INT-1. 
For terminals attached to a remote OS/3 system, the default for the PROTYP operand must be used. If you 
are using DDP, you must also specify PROTYP=XPARENT on the LOCAP macro. 


When you use remote batch terminals in a DCA/DCP environment, the TERM macro must include PROTYP=RB-2, 
RBATCH=YES,XLATE(NO,NO). For terminals connected to a remote OS/3 system, the default for the PROTYP 
operand must be used. 


Macros that apply to circuit-switched and packet-switched public data networks (PDNs) are not shown for 


simplicity sake. A DATEX-L circuit switched PDN is a special case that can be defined in a dedicated or single- 
node global network with operands on the LINE and TERM macros. (A virtual line is not used for DATEX-L.) 
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3.2. 


3.2.1. 


3-6 


Dedicated Network Definitions 


In a dedicated network, lines and terminals are dedicated (assigned) to one program 
only. They cannot be reassigned to another program until the network is released. 


You can have more than one program executing at the same time, but you must define 
independent networks for each program. 


Dedicated networks are simpler to define than the global networks described later in 
this section, but they are limited because: 


¢ Programs cannot share lines and terminals. 


¢ Your communications system cannot support more than one central processor. 


Direct Data Interface Network Definition 


The direct data interface (DDI) network definition uses a limited set of network 
definition macros as shown in Table 3-1. The DDI does not support message queuing, 
process files, network buffering, distribution lists, disk buffering, MPPS, journaling, 
global networking, or message formatting. 


The suggested order of presentation of macros is shown in Table 3-3. You can 
generate several networks in the same ICAM symbiont, and all of the networks need 
not be DDI networks. 


Figure 3-1 shows a typical direct data interface network with two communications 
lines. Line 1 is a switched line with two UNISCOPE 100 display terminals. Line 2 is 
a dedicated line, and it connects a 1004 card processing system. The lines are 
synchronous and operate in two-way alternate mode at a transmission rate of 2000 
baud. The card processor provides a remote site identifier of PSDC, and the phone 
numbers are 123-4567 and 123-4568 respectively. (The hyphen creates a short delay 
in dialing if you need it.) 


Figure 3-2 shows the network definition for the network in Figure 3-1. Note the 
simplicity of the coding. This is because DDI does not support most of the ICAM 
features supported by standard interface, dedicated, and global networks. The macros 
that are supported are indicated in Table 3-1. Where there are differences between 
support for this type of network and the other types of networks for a given macro, the 
differences are described in the macro descriptions in Section 2. 
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Table 3-3. Order of Presentation of Macros in a Direct Data Interface (DDI) Network Definition 
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Macro 
CCA, 


BUFFERS 


LINE 


TERM, 


TERM, 
LINE, 


TERM 


TERM, 
ENDCCA) 
CCA 


n 


ENDCCA,, 


Remarks 
Identifies the beginning of an ICAM DDI network definition 


Creates an activity request packet pool and a network buffer 
pool if datagrams are required 


Identifies the characteristics of the first line 


Defines the characteristics of the first terminal on this line 
Defines the characteristics of the last terminal on this line 
Identifies the characteristics of the last line 


Defines the characteristics of the first terminal on this line 


Defines the characteristics of the last terminal on this line 


Ends this network definition 


Identifies the start and end of the last network definition 
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LNE1 


CALL=1234567 


DEVICE=(UNISCOPE) 
TYPE= (2000, SWCH, SYNC) 





LINE 1 









TRM2 


ADOR= (24,56) 
FEATURES= (U100) 


TRM1 TERMINAL 2 


ADDR=(24,55) 
FEATURES= (U100) 





TERMINAL 1 









CCA TYPE=(DDI) 






BUFFERS ARP=20 









UNISCOPE 
TERMINALS 










CALL=1234568 








DEVICE=(1004) 
TYPE=(2000,SYNC) 
ID=4 


TRM3 


FEATURES=1004 
ANSWER=(3,C ,PSDC) 


TERMINAL 3 


Figure 3-1. Direct Data Interface (DD]) Network 
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NET1 CCA TYPE=(DDI) 
BUFFERS ARP=20 


LNE1 LINE CALL=123-4567, x 
DEVICE=(UNISCOPE), x 
TYPE=( 2000, SWCH, SYNC) 

TRM1 TERM FEATURES=(U10@), x 
ADDR=(24 ,55) 

TRM2 TERM FEATURES=(U100, 1024), x 
ADDR=(24 ,56) 

LNE2 LINE CALL=123-4568, xX 


DEVICE=( 1004), 
TYPE=(2000, SYNC), 
1D=4 
TRM3 TERM _—~ FEATURES=( 1004), x 
ANSWER=(4,C,PSDC) 
ENDCCA 


Figure 3-2. Coding for a Direct Data Interface (DDI) Network Definition 


3.2.2. Standard Interface Dedicated Network Definition 


The standard interface (STDMCP) dedicated network provides a complete, logical, 
queued communications facility. This interface enables communications between a 
group of terminals you define as a communications network and one of your programs. 
When one of your programs activates a standard interface dedicated network, the 
terminals, process files, etc., that are identified in that network are available only to 
that program. The resources are held until your program releases the network, 
thereby making them available to another one of your programs. 


You may define several dedicated networks in one ICAM symbiont and activate one at 
a time with the same program, or you can activate all of them by means of several of 
your programs, (See the ICAM Technical Overview (UP-9744) for details.) 


You should use the facilities available through standard interface global networks if 
you are writing a program that needs to do any of the following: 


e Send and receive messages to or from any terminal in your total communications 
environment 


¢ Communicate between your programs in the same computer or between 
computers 


¢ Make available to any of your programs messages input from any of the 
terminals in the system 


¢ Run several of your communications programs concurrently using the same 
network 
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Table 3-4 shows the recommended order of presentation of macros for a STDMCP 
dedicated network definition. 


Table 3-4. Order of Presentation for Macros in a Standard Interface and Transaction Control 
Interface Dedicated Network Definition 


Macro Remarks 
CCA} Identifies the beginning of a network definition 
BUFFERS Generates required system resources 
LINE l Defines the characteristics of the first line 
TERM, Specifies the characteristics of the first terminal on this line 
TERM, Specifies the characteristics of the last terminal on this line 
LINE, Defines the characteristics of the last line in the system 
TERM l Specifies the terminal definitions for the last line in this 
network 
EUP, Specifies the optional end-user profile for message format 





editing, if used 


TERM, Defines the characteristics of the last terminal on this line 
EUP,, 
DISCFILE, Specifies the first disk file used with this network 
DISCFILE,, Specifies the last disk file used 
JRNFILE) Specifies the first journal file for this network 
JRNFILE : Specifies the last journal file for this network 
continued 
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Table 3-4. Order of Presentation for Macros in a Standard Interface and Transaction Control 
Interface Dedicated Network Definition (cont.) 


Macro Remarks 
DLIST) Specifies one or more distribution lists for this network 
definition 
DLIST,, 
PRCS Specifies the first process file for this network 
PRCS,, Specifies the last process file for this network 
MPSTART) Specifies the beginning of the first optional message 
processing procedure specification (MPPS) routines 
MPPS macros 
MPSTART,, Specifies the beginning of the last optional MPPS routine 
MPPS macros 
ENDCCA) Identifies the end of this network definition 
CCA, 
Identifies the start and end of the last dedicated network 
definition 
ENDCCA, 





* Message processing procedure specification (MPPS) routines are described in the 
ICAM Programming Reference Manual (UP-9749). 


Basic Standard Interface Dedicated Network Definition 


Figure 3-3 shows an example of a basic standard interface dedicated network using 
two communications lines. One communications line is a manually dialed (switched) 
line with a single DCT 500 terminal connected to it. The DCT 500 terminal operates 
in automatic mode. The other line is a dedicated line having two UTS 400 terminals 
attached. 


Figure 3-4 shows the coding for this network definition. Each line of coding is 


annotated as to its meaning. In addition, parts of the coding are shown in Figure 3-3 
to further simplify the example. 
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OUTPUT 
QUEUE 
FOR 

TRM2 


OUTPUT 
QUEUE 
FOR 

TRM3 


















DEVICE =(UNISCOPE) 
TYPE =(9600,SYNC) 
























FEATURES=(U400,960) 
ADDR>{21,51) 
PINTV=30 


FEATURES=(U400,960) 
ADDR=(21,52) 
PINTV=30 


INPUT=PRC2 INPUT=(YES) 
LOW=MAIN LOW=MAIN 
ALTO=TRM3 





CCA 
TYPE=(STDMCP) 
PASSWORD=XJHB 

BUFFERS 100,64,10, 

ARP=24, 

STAT=YES 












UTS 400 
TERMINALS 


TERMINAL 2 TERMINAL 3 
LNE1 


DEVICE=(DCT500,AUTO) 
TYPE=(300,SWCH) 
LBL=4 





CALL=2918 
INPUT=(PRC1) 





PROCESS FILE 1 






FEATURES=(DCT500) 
ADDR=(41751} 
LOW=MAIN 


OUTPUT 

QUEUE 
FOR 

TRM1 





TERMINAL 1 
DCT 500 


Figure 3-3. Standard Interface Dedicated Network with No Auxiliary Devices 
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1. {NET1 CCA TYPE=(STDMCP) , PASSWORD=XJHB, xX 
CCAID=JHBNET , FEATURES=(OPCOM) 

2. BUFFERS 100,64, 10,ARP=24,STAT=YES 

3.)LNE1 LINE DEVICE=(DCT,5000), TYPE=(300,SWCH), x 
LBL=4, CALL=2918, INPUT=(PRC1) 

4.|TRM1 TERM FEATURES=(DCT50@) ,ADDR=(41,51) ,LOW=MAIN 

5.]LNE2 LINE DEVICE=(UNISCOPE), TYPE=(9600,SYNC), ID=8,LBL=128 

6.|TRM2 TERM FEATURES=(U400,96@) , ADDR=(21,51) ,PINTV=3@, X 

INPUT=(PRC2) , LOW=MAIN, ALTD=TRM3 
7./TRM3 TERM FEATURES=(U400,960) ,ADDR=(21,52) ,PINTV=30, X 
INPUT=(YES) , LOW=MAIN 

8.{PRC1 PRCS LOW=MAIN 

9. 1PRC2 PRCS LOW=MAIN 

10. ENDCCA 

Notes: 

1. STDMCP indicates this is the beginning of a network defintion for a standard interface dedicated 
network named NET1. A password (XJHB) is defined, JHBNET is to placed at the top of each listing 
page, and operator communications are required. 

2. Establishes a network buffer pool of 100 64-word network buffers with a threshold of 10. There are 24 
activity request packets specified along with counters to accumulate statistics on the use of the network 
buffer and activity request packet pools. 

3. Defines line 1. It supports DCT 500 terminals in automatic mode at 300 baud on a switched (dialed) 
line. The line buffer length is 4 words. The terminal phone number is 2918 and input from this line is 
directed to process file PRC1 unless overridden by an INPUT operand in the TERM macro. 

4. Defines the DCT 500 terminal. The device address is 41,51 and an output queue is established for it by 
means of the LOW=MAIN operand. The input from this terminal is directed to PRC1. 

5. Defines the second line. It supports UTs 400 terminals by means of the UNISCOPE remote device 
handler on a 9600-baud synchronous line. The SLCA ID is 8 and the line buffer length is 128 words. 

6. Defines the first UTS 400 terminal. It has a screen size of 960 characters; its rid,sid address is 21,51; 
itis polled every 3 seconds; and its input is placed on process file PRC2. A main storgae output queue 
is established and an alternate destination is established (terminal 3). 

7. Defines the second UTS 400 terminal on line LNE2. Its definition is almost the same as the first 
terminal except that its input is placed on a special input queue for terminal TRM3 (INPUT=YES). 

8. Defines a process file (PRC1). 

9. Defines a process file (PRC2). 

10. Indicates the end of this network definition. 
Figure 3-4. Coding for a Standard Interface Dedicated Network with No Auxiliary Devices 
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Standard Interface Dedicated Network Definition Using a Message Processing Routine 


Figure 3-5 shows a standard interface dedicated network used with UNISCOPE 
terminals, Teletype Model 33 terminals, and a 1004 system. In addition, two message 
processing routines are used. Message processing routines are described in the ICAM 
Programming Reference Manual (UP-9749). This example shows how to include 
message processing routines in a network definition with disk files. Figure 3-6 is the 
same network coded into a network definition. Notice that the INPUT operands in 
the LINE and TERM macros reference the message processing routine that handles 
input and output for that line or terminal. 







OUTPUT 
QUEUE 
HIGH=MAIN 





UNISCOPE UNISCOPE UNISCOPE UNISCOPE 


CCA LNE2 
PASSWORD=JHB 
TYPE=(STDMCP) 

BUFFERS 
20,100, ARP=24 





OUTPUT 
QUEYE 
HIGH=MAIN 






LNE3 


OUTPUT 
QUEUE 
HIGH=MAIN 


Figure 3-5. Standard Interface Dedicated Network Using a Message Processing Routine 
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NET1 CCA —- PASSWORD=JHB, TYPE=(STDMCP) 
BUFFERS 20,100, ,ARP=24 
LNE1 LINE CALL=6461062,DEVICE=(UNISCOPE), X 
TYPE=(2000,SWCH, SYNC), INPUT=(MPSA,6), x 


HIGH=MAIN , MEDIUM=DISC1, LOW=DISC2 

TRM1 TERM ADDR=(29,53) , FEATURES=(U100, 1024) , PINTV=50 

TRM2 TERM ADDR=(29,54) , FEATURES=(U100, 1024) ,PINTV=5 

TRM3. TERM ADDR=(28,51), FEATURES=(U100, 1024) , PINTV=5@ 

TRM4 TERM ADDR=(28,52), FEATURES=(U100, 1024) , PINTV=5 

LNE2 LINE CALL=6460262, DEVICE=(TTY,33), x 
TYPE=(100, SWCH) , INPUT=(MPSB,9) 

TRMS TERM FEATURES=(TTY) , HIGH=MAIN 


LNE3 LINE CALL=6462766,DEVICE=( 1004), X 
TYPE=(2400,UNAT, SWCH, SYNC), X 
1D=8, INPUT=(MPSB,9) 

TRM6 TERM ANSWER=(5,C,NYCO1), X 


FEATURES=( 1004) , HIGH=MAIN 
PRF 1 PRCS  LOW=MAIN 
PRF2 PRCS LOW=MAIN 
PRF3 PRCS  LOW=MAIN 
DISC1 DISCFILE FILEDIV=10 
DISCc2 DISCFILE FILEDIV=10 
MPSA MPSTART 
RECHDR 
DIRECT  P,PRF1,L 
TIMSTP 
RECEND 
CANCELM TN#MBINS 
RECPST 
SENHDR 
SENEND 
RETRANS X'FFFF! 
SENPST 
MPSB MPSTART 
RECHDR 
MSGTYP 3, TTY, TYPE2 
DIRECT —— P, PRF3,L 
BRANCH REND 
TYPE2 MSGTYP 4,1004,TYPE3 
ADVANCE 4,DATE 
DATSTP sd 
DIRECT =P, PRF3. 
BRANCH — REND 
TYPES DIRECT — SOURCE,,L 


Figure 3-6. Coding for the Standard Interface Dedicated Network Using a Message Processing 
Routine (Part 1 of 2) 
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REND RECEND 

RECPST 

SENHDR 

MSGTYP 3, TTY, NOSEQOUT 

SEQOUT 3 


NOSEQOUT SENEND 
REROUTO TN#MLERR, TRM1 
SENPST 
ENDCCA 


Figure 3-6. Coding for the Standard Interface Dedicated Network Using a Message Processing 
Routine (Part 2 of 2) 


Standard Interface Dedicated Network Definition with Auxiliary Devices 


Figure 3-7 shows a communications network similar to the one shown in Figure 3-5, 
except that auxiliary devices have been added to the UTS 400 terminals. Two devices 
have been added to each terminal: one communications output printer (COP), and one 
tape cassette system (TCS). The auxiliary devices are specified with AUXn operands. 
Each AUX operand creates a displacement in an ICAM table, i.e., AUX1 refers to the 
first entry, and AUX4 refers to the fourth. 





Your program uses these displacements to communicate with a particular auxiliary 
device. Some auxiliary devices, as shown in Figure 3-8, require four auxiliary device 
addresses (dids). Because of this, you have to be careful when you specify the AUX 
operand to allow for the extra device addresses. In the example, the COP of the TRM2 
requires only one device address specified by AUX1. The TCS has two tape cassette 
drives, and each one of them requires two device addresses (usually, one for input and 
one for output). Therefore, AUX2 covers the second and third dids, and AUX4 covers 
the fourth and fifth. Remember that AUX3 is already used when you specify the 
second tape drive. 
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INPUT 
QUEUE 
INPUT=YES 


INPUT 
QUEUE ~- 
LOW=MAIN 


OUTPUT 
QUEUE 
LOW=MAIN 





LNE2 






LINE 
DEVICE =(UNISCOPE) 
TYPE = (9600) 

1ID=8 

LBL= 128 


















PROCESS FILE 2 








FEATURES =(U400,960) 
ADDR = (21,51) 

PINTV =30 
AUX1=(COP,73), 

AUX2 =(TCS,74,75) 
AUX4=(TCS,76,77) 


FEATURES=(U400,960) 
ADDA=(21,52) 
PINTV=30 
AUX1=(COP,78) 
AUX2=(TCS,79,80) 
AUX4=(TCS,81 82) 






































INPUT =PRC2 
LOW=MAIN 
ALTDO=TRM3 


INPUT=(YES) 
LOW=MAIN 





TERMINAL 2 
UTS 400 


CCA 
TYPE=(STDMCP} 
PASSWORD=JHBNET 

BUFFERS 100,64,10, 

ARP=24, 

STAT=YES 


TERMINAL 3 
UTS 400 














COMMUNICATIONS OUTPUT TAPE CASSETTE COMMUNICATIONS OUTPUT 
PRINTER (COP) SYSTEM (TCS) PRINTER (COP) 


LNE1 







TAPE CASSETTE 
SYSTEM (TCS) 


DEVICE=(DCT500, AUTO) 
TYPE=(300,SWCH) 
LBL=32 

CALL=2918 
INPUT=(PRC1) 






TRM1 





PROCESS FILE 1 FEATURES=(DCT500) 
ADDR=(41,51) 
LOW=MAIN 


OUTPUT 
QUEUE 
LOW=MAIN 





TERMINAL 1 
DCT 500 


Figure 3-7. Standard Interface Dedicated Network with Auxiliary Devices 
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NET1 CCA TYPE=(STDMCP) , PASSWORD=JHBNET, x 
CCAID=JHBNET , FEATURES=(OPCOM) 
BUFFERS 10@,64,10,ARP=24,STAT=YES 


LNE1 LINE DEVICE=(DCT5@@, AUTO) , TYPE=(30, SWCH), x 
LBL=32, CALL=2918, INPUT=(PRC1) 

TRM1 TERM FEATURES=(DCT5@@) , ADDR=(41,51) , LOWSMAIN 

LNE2 LINE | DEVICE=(UNISCOPE) , TYPE=(9600, SYNC) , ID=8,LBL=128 

TRM2 TERM FEATURES=(U40@, 960) , ADDR=(21,51) ,PINTV=30 x 
AUX1=(COP, 73) , AUX2=(TCS, 74,75) ,AUX4=(TCS, 76,77), x 
INPUT=(PRC2) , LOW=MAIN, ALTD=TRM3 

TRM3 TERM FEATURES=(U400,960) ,ADDR=(21,52) , PINTV=3@, x 
AUX1=(COP, 78) , AUX2=(TCS, 79, 7A) , AUX4=(TCS, 7B, 7C), x 
INPUT=(YES) , LOW=MAIN 

PRC1 PRCS LOW=MAIN 

PRC2 PRCS LOW=MAIN 

ENDCCA 


Figure 3-8. Coding for a Standard Interface Dedicated Network with Auxiliary Devices 


3.2.3. TCI Dedicated Network 


3-18 





The TCI network is available for the IMS user only. You code the dedicated TCI @ 
network definition like the dedicated STDMCP, except for the TYPE operand of the 
CCA macro - you must specify TYPE=(TCI). 


TCI networks require disk buffering (not disk queuing) for input message handling. 
Therefore, use the INPUT operand in LINE and TERM macros to specify only a 
message processing routine. You may specify HIGH, MEDIUM, and LOW operands 
for output message queuing in the LINE or TERM macros. These queues may be on 
disk or in main storage. Disk buffering for output is not supported. 


The transaction control interface network definition uses the macros provided in 
Section 2 of this user guide. Table 3-1 summarizes all of the macros that apply to this 
type of network definition. You create an ICAM symbiont by submitting your network 
definition to the system generation procedures described in Section 5, and the 
suggested order of presentation of macros is shown in Table 3-4. Note that you can 
generate several network definitions in the same ICAM symbiont at system 
generation, and that all of the networks need not be transaction control interface 
networks. For complete details on generating an ICAM network that supports IMS, 
see the IMS System Support Functions Programming Guide (UP-11907). 


The transaction control interface network shown in Figure 3-9 is a 2-line system 
supporting multiple UNISCOPE terminals with attached auxiliary devices connected 
to one of the lines. Connected to a separate line is a DCT 500 terminal. Figure 3-10 
shows how to code the network definition to support the network. 


For additional network definition examples, see the IMS System Support Functions 
Programming Guide (UP-11907). @ 
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ADDR=(29,53) 
FEATURES=(U100,960) 
LOW=DOFILE3 
PINTV=10 
AUX1={TCS.74,75) 
AUX3=(TCS, 76,77} 










AODR=(28,52) 
FEATURES=(U100,960} 
LOW=DOFILE2 
PINTV=10 
AUX1={TCS.74,75) 
AUX3={TCS,76,77) 


ADDR=(28,51) 
FEATURES=(U100,960) 
LOW=DOFILE1 
PINTV=10 
AUX1=(TCS, 74,75) 
AUX3={TCS,76,77) 















ONET 





CCA TYPE=(TCI) 
BUFFERS=5,64,0 
ARP=24 
PASSWORD=DISCNET 
FEATURES=(OUTOELV) 



















UNISCOPE 


UNISCOPE 
TERMINAL 


TERMINAL 





TAPE CASSETTE 
SYSTEM (TCS) 


TAPE CASSETTE 
SYSTEM {FCS) 


LINE 2 





TERM 


CALL =555777 

DEVICE = {(DCTS00,TT7} 
TYPE = (300.SWCH} 
1D-9 





ADODR=(29,54) 
FEATURES=(U100,960) 
LOW=DOFILE4 
PINTV=10 
AUX1=(TCS, 74,75) 
AUX3=(TCS, 76,77) 


U1H4 













wl 





DCT 500 


Figure 3-9. Disk Queued TCI Network with Auxiliary Devices 
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TERMINAL TERMINAL 
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TAPE CASSETTE 
SYSTEM (TCS) 
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CCA TYPE=(TCI) , PASSWORD=DI SCNET , FEATURES=(OUTDELV) 
BUFFERS 5,64,0,ARP=24 
LINE DEVICE=(UNISCOPE) , TYPE=(2400,SWCH, SYNC) , CALL=5556666 


TERM ADDR=(28,51), FEATURES=(U100, 960) , PINTV=10, X 
LOW=DQFILE1, x 
AUX 1=(TCS,74,75)AUX3=(TCS, 76,77) 

TERM ADDR=(28,52) , FEATURES=(U100, 960), PINTV=10, x 
LOW=DQF ILE2, x 
AUX1=(TCS, 74, 75)AUX3=(TCS, 76,77) 

TERM ADDR=(29,53), FEATURES=(U100,960) , PINTV=18, x 
LOW=DQFILE3, X 
AUX1=(TCS 74,75 )AUX3=(TCS,76,77) 

TERM ADDR=(29,54) , FEATURES=(U100, 960) ,PINTV=10, x 
LOW=DQFILE4, X 


AUX1=(TCS, 74,75 )AUX3=(TCS, 76,77) 
LINE DEVICE=(DCT500, TTY), TYPE=(30@, SWCH) , CALL=5557777, ID=9 
TERM — FEATURES=(DCT500) , LOW=DQFILE4 
DISCFILE FILEDIV=6 
DISCFILE FILEDIV=6 
DISCFILE FILEDIV=2 
DISCFILE FILEDIV=3 
DISCFILE MSGSIZE=1024 
ENDCCA 


Specifies the output delivery notification feature. 


A synchronous, switched line. The line terminates four UNISCOPE terminals, two with rid 28 and two 
with rid 29. Each UNISCOPE terminal has a 960-character screen and a pol interval of 1 second. Line 
speed is 2400 baud. 


Specifies an auxiliary tape cassette subsystem (TCS). 


An asynchronous, switched line with line speed of 300 baud on SLCA 9. The line terminates a DCT 500 
in teletypewriter mode. , 


Defines disk files for disk queuing. Three files are used in line LOO] and one file is used in line LOO2 for 
disk-queued output. 


1. |ONET 

2. {L001 
U1H1 

3. 
UtH2 
U1H3 
U1H4 

4. {L002 
TTY1 

5. |DQFILE1 
DQFILE2 
DQFILE3 
DQFILE4 

5. |TCIOTF 

Notes: 

1. 

2. 

3. 

4. 

on 

6. 


Defines a disk buffering file for input. 


Figure 3-10. Coding for the TCI Network with Auxiliary Devices and Disk Queuing 
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3.3. 


Global Network Configurations 


In a global ICAM network, all user programs share network resources such as lines 
and terminals. Your program can communicate with any other end user in the 
network - terminal, process file, or LOCAP file. 


You can create a global network to operate in a single computer (single-node global 
network) as shown in Figure 3-11, or you can create one to operate between two or 
more computers (multinode global network) as shown in Figure 3-12. 


Within each computer node, all resources (terminals, process files, LOCAP files, and 
queues) are assigned to a supporting ICAM program known as the global user service 
task (GUST). GUST allocates resources between end users, as required by your 
programs, within the global network. 


Since a global network does not exclusively belong to any one of your programs as in a 
dedicated network, your program can request attachment (connection) to the global 
network and use currently idle resources in the global network at any time, even 
though other programs are already attached to the global network. In a network as 
shown in Figure 3-11, your program can send to any end user but can only receive 
(access) a message from its own LOCAP file. 


Global network configurations in a multinode global network environment are 
connected by a physical link called a virtual line or VLINE. Each VLINE supports up 
to 4,095 logical subchannels as specified in the PORT operand of the LPORT macro. 
In this environment, a global network resides in each computer node, and, of course, 
these networks must relate to each other. Figure 3-12 illustrates an ICAM multinode 
global network. Typically, a node in a multinode global network has an environment 
similar to that shown in Figure 3-12. 


Figure 3-13 illustrates various configurations of global networks. 
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ICAM INTERFACE 







USER 
PROGRAM LOCAP 1 
1 








| | TERMINAL 


LINE 2 







USER 
PROGRAM LOCAP 2 
2 





TERMINAL 
} 


NOTE: 


The dashed lines indicate possible session paths. 





TERMINAL 


Figure 3-11. Single-Node Standard Interface Global Network 
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TERMINALS 





USER 
PROGRAMS 





STANDARD ICAM COMPONENTS 





VIRTUAL CHANNEL STAGING 


VIRTUAL CHANNEL 
ROUTING 
TRANSMISSION CONTROL 


TRUNK CONTROL 
FLOW CONTROL 





COMPUTER 1 
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TERMINALS 





USER 
PROGRAMS 







STANDARD ICAM COMPONENTS 


VIRTUAL CHANNEL STAGING 


VIRTUAL CHANNEL 
ROUTING 
TRANSMISSION CONTROL 
TRUNK CONTROL 

FLOW CONTROL 









COMPUTER 2 


Figure 3-12. Multinode Global Network Environment 
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USER CCA 
PROGRAMS TYPE ICAM LINE/PORT CHARACTERISTICS 


SINGLE NODE LINE 
CCA TYPE =(GBL) 








GET/PUT LOCAP TYPE =(STOMCP) NON-DCA 
PROGRAM GLOBAL 
NETWORK 






























DATEX-L LINE CIRCSW = (DATEX) 
GET/PUT 
PROGRAM 
VLINE DEVICE - (ABM) 
STDMCP 
LOCAP TYPE = (STDMCP) LPORT USERTP _(STOMCP} 
bik hd aaa LOCAP TYPE = (OM! ee CCA TYPE GBL,DCA = YES VLINE DEVICE (ABM 
SERVICES _ GLOBAL . DDP/IAS { TORT GeEATP (OMI 
PROGRAMS LOCAP TYPE = (TCH) NETWORK 
VLINE DEVICE - (ABM! 
LPORT USERTP - (TCI 
IMS 
PROGRAM : 
VLINE DEVICE = (LAPB 
PDN CARRIER TRANSPAC 
TRANSPAC TRUNK 
SuB 
VLINE DEVICE =(LAPA) 
PON CARRIER _ DATAPAC 
DATAPAC | TRUNK 
SuB8 
VLINE DEVICE = (LAP 
PDN CARRIER - DATEX 
DATEX-P Then 
SUB 
VLINE DEVICE = (LAPB 
PON CARRIER = 00X 
POR TRUNK 
- SUB 
VLINE DEVICE = (LAPS) 
PON CARRIER = IBERPAC 
IBERPAC TRUNK 
SUB 
VLINE DEVICE = (LAPB) 
PSS PDN CARRIER =PSS 
RUNK 
SUB 
VLINE DEVICE =(ABM 
PON PDN CARRIER = NORDIC 
PUDTE 
RDTE 


Figure 3-13. ICAM Non-DCA and DCA Global Networks 
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Order of Presentation for Global Network Definition Macros 


Table 3-5 shows the recommended order of presentation for global network 
definitions. The order of presentation and most of the statements are the same as in 
an STDMCP dedicated network definition (3.2.2). This is because global networks are 
an extension of the STDMCP dedicated network concept. 


As in all network definitions, the CCA macro starts a global network definition, and 
the BUFFERS macro defines the system requirements for network buffers and 
activity request packets. In a global network definition, you must specify LOCAP files 
for all your user programs by means of LOCAP macros inserted at this point. LINE 
and TERM macros follow, defining the characteristics of each line and terminal 
connected to it. (Output queues are defined in LINE and TERM macros by HIGH, 
MEDIUM, and LOW operands.) If you are using remote workstations in your 
network, a poll group (PGROUP) macro is required and precedes the TERM macros 
within that group of terminals. 


Next, you specify any disk files, journal files, process files, and distribution lists you 
may need by means of DISCFILE, JRNFILE, PRCES, and DLIST macros. 


If you want to define static (permanent) sessions between end users, you use 
SESSION macros. You must not specify SESSION macros for sessions that are 
established dynamically. At this point, you can define any message processing 
routines you want in the global network. Each message processing routine is 
introduced by an MPSTART macro. An ENDCCA macro would end the network 
definition here if you were defining a single node global network. 


If you are defining a multinode standard interface global network, you must supply a 
definition for the virtual line (the physical link between two computers). Do this by 
means of the VLINE macro. In addition, you must define the end users in the remote 
computers. Do this by means of LOCAP, TERM, and PRCS macros that have the 
REMOTE operand specified. You must not specify LINE macros for the remote 
computer because lines are not considered end users. 


Finally you end the network definition with the ENDCCA macro. 


Only one global network definition can operate at a time in the processor. You can 
mix global and dedicated network definitions in the same symbiont. 
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Table 3-5. Order of Presentation of Macros in a Global Network Definition 





Macro Remarks 
CCA Identifies the beginning of a global network definition 
BUFFERS Specifies required system resources 
LOCAP, Specifies all local user programs (i.e., in this node) this line 
LOCAP, Specifies the characteristics of the last terminal on this line 
LINE; Defines the characteristics of all local lines 
PGROUP Specifies a poll group when using remote workstations only 
TERM) Specifies the characteristics of the first terminal on this line 
EUP) Specifies end-user profile for this terminal (message 
formatting function) 
PGROUP 
TERM, Specifies the characteristics of the last terminal on this line 
EUP,, 
LINE, Defines the characteristics of the last line in the system 
PGROUP 
TERM) 
EUP) 
PGROUP 
TERM, 
EUP,, 
DISCFILE, Specifies the first disk file used for this network 
DISCFILE,, Specifies the last disk file used 


continued 
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Table 3-5. Order of Presentation of Macros in a Global Network Definition (cont.) 


Macro 


JRNFILE, 


JRNFILE,, 


PRCS 


PRCS,, 


DLIST, 


DLIST,, 


SESSION, 


SESSION, 


MPSTART 


MPSTART,, 
CONGRP 
VLINE, 
STATION, 
STATION, 


LPORT 


LPORT 


TERM 


TERM 


UP-9745 Rev. 3 


Remarks 


Specifies the first journal file for this network 


Specifies the last journal file for this network 


Specifies the first local process file in this network 


Specifies the last local process file in this network 


Specifies one or more distribution lists for this network 


Specifies the static local session between local end users 
(.e., in this computer node) 


Specifies the last static local session 


Specifies MPPS, if required; the required MPPS macros 
follow the MPSTART statements 


Specifies the beginning of the last optional MPPS routine 
Defines the station group when NRM line control is used 


Specifies the first VLINE for this network and the resources 
associated with it 


Specifies the characteristics of a station and flow control 
required by NRM link level control network and the resources 


Specifies the logical ports for VUINE} (or STATION), if NRM) 
when distributed communications architecture is defined 


Resources defined in a remote computer node 


continued 
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Table 3-5. Order of Presentation of Macros in a Global Network Definition (cont.) 
Macro Remarks 
PRCS 


; Resources defined in a remote computer node 
PRCS 





LOCAP 
CGRPEND Specifies the end of the UDLC/NRM configuration group 
definition 
VLINE,, Specifies the last VLINE for this network and the resources 
associated with it 
LPORT Specifies the logical ports for distributed communications 
architecture in VLINE, 
LPORT 
TERM 
TERM 
PRCS Resources defined in the remote computer node 
PRCS 
LOCAP 
ENDCCA Identifies the end of this global network definition 
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3.3.2. Using Queues in a Global Network 


UP-9745 Rev. 3 


Program Queues 


You can specify up to three special queues via the HIGH, MEDIUM, and LOW 
operands in a LOCAP macro. These queues belong only to the program named in 
the label of the LOCAP macro and only that program can access messages placed 
on them. Your program accesses the queues by using a GETCP and referencing 
its name in the related DTFCP. Any end user, such as another program, can 
place messages on these queues by issuing a Put request and addressing your 
program in the same manner as a process file. 


If a program receiving a message resides in a remote node, defined by the 
REMOTE operand in the LOCAP macro, only ICAM can access the queues to 
transfer queued messages to the program located in the remote node. In this 
case, the queues become destination queues for the remote program. 


Process File Queues 


Process file queues are used for temporary storage of messages destined for a 
program. Any program may issue a Put request to place a message on a process 
file or issue a Get request to access a message existing on a process file. The low, 
medium, and high message queues are both destination queues (the Put side) and 
input queues (the Get side). 


If a message is directed to a process file that is located in a remote node, the 
message is stored on a local process file (of the same name) that has the remote 
operand specified. ICAM can access the Get side of this process file only to 
transfer a queued message over the virtual link (VLINE) to the destination 
process file. The final process file is local to the remote node and, therefore, any 
program in the remote node can access the message. This design prevents local 
programs from accessing process files and removing messages destined for 
remote nodes. 


Each terminal can have up to three output priority queues for messages destined 
to it. They are created via the HIGH, MEDIUM, and LOW operands on the 
TERM macro. In addition, a single input queue can be created for all input 
messages from the terminal via the INPUT=YES operand in the TERM macro. 
Your program accesses this input queue via the label specified on the TERM 
macro in the related DTFCP for the Get request. 


The terminal input can be directed to any remote or local end user via the 
INPUT=end-user-name in the TERM macro. For example, if all terminal input is 
going to another terminal called TRM2, the label of the destination terminal in 
the INPUT operand of the source terminal’s TERM macro is INPUT=TRM2. 
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3.4. 


3.4.1. 
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Single-Node Global Networks 


In a global network definition for a single node, you can specify a LOCAP macro for a 
user program (STDMCP), ICAM terminals as workstations connected to interactive 
services (DMI), or an IMS user (TCI). 


The basic differences in defining single-node global networks are: 


Standard Interactive 
Basic Interface Services IMS 
Macro User User User 
CCA TYPE=(GBL, ,node) TYPE=(GBL, ,node) TYPE=(GBL, ,node) 
LOCAP TYPE=(STDMCP) TYPE=(DMI) TYPE=(TCI) 


, TAS=(YES, OFF) 


Local workstations are directly connected to interactive services and do not require 
any operands or statements in an ICAM network definition. However, if a local 
workstation must communicate with one of your programs, you must define it in a 
LINE and TERM macro as follows: 


Macro Operand Affected 

LINE DEVICE=(LWS) 

TERM FEATURES=U2@, ADDR=(dev- addr) 
OR U40 
OR 1122 


Single-Node Standard Interface Global Network 


Figure 3-14 illustrates a single-node global network definition. Two programs use this 
network - CUP1 and CUP2. These are identified in the network by the two LOCAP 
macros. Notice that each LOCAP macro includes three operands to create input 
queues. The HIGH, MEDIUM, and LOW operands create input queues that enable 
the programs to receive input messages directly. SESSION macros are used to 
establish static sessions between the end users in this network. Sessions can be 
established dynamically by means of the ICAM dynamic session establishment 
feature. In this case, SESSION macros are not specified. However, if you specify a 
static session between a terminal and another end user, you cannot then establish 
dynamic sessions with that terminal. 
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1 72 
1. |GNSN CCA _—‘ TYPE=(GBL, ,S) , FEATURES=(OPCOM) 
BUFFERS 40,64,9,ARP=35, STAT=YES, EXPFACT=50 
2. |cup4 LOCAP TYPE=(STDMCP) , LOW=FILEA,MEDIUM=F ILEA, HIGH=FILEA 
3. |cup2 LOCAP TYPE=(STOMCP) , LOW=FILEA,MEDIUM=FILEA, HIGH=FILEA 
4. |LNE4 LINE DEVICE=(UNISCOPE) , TYPE=(2400, SWCH, SYNC) , ID=12 
5. |TRM1 TERM ADDR=(28,51) , FEATURES=(U2@), X 
LOW=FILEA,MEDIUM=FILEA, HIGH=FILEA, x 
INPUT=C(YES, , FILEA) 
TRM2 TERM ADDR=(28,52) , FEATURES=(U2@), x 
LOW=F ILEA, MEDIUM=FILEA, HIGH=FILEA, x 
INPUT=CYES, , FILEA) 
6. |TRM3 TERM ADDR=(29,53) , FEATURES=(U2), X 
LOW=FILEA, X 
INPUT=(TRM4) 
TRMG. TERM ADDR=(29,54) , FEATURES=(U2), X 
LOW=FILEA, X 


INPUT=(TRM3) 

7. |FILEA DISCFILE FILEDIV=15 
8. SESSION EU1=(CUP1) ,EU2=(CUP2) 
SESSION EU1=(CUP1) ,EU2=(TRM1) 
SESSION EU1=(CUP1) ,EU2=(TRM2) 


SESSION EU1=(TRM3) ,EU2=(TRM4) 
@ ENDCCA 
Notes: 
1. Designates this network as a global network with the node name of S. 
2-3. Define LOCAP files for CUP1 and CUP2 with three disk queues each. 


4, Defines a local switched synchronous line operating at 2400 baud using UNISCOPE terminals. 


5. Defines a UTS 20 terminal on line LNE1 with a rid, sid address (28,51); three disk output queues (all with the 
same name); and a disk input queue (FILEA). 


6. Defines another UTS 20 terminal on line LNE1 with a rid,sid address (29,53) and a low priority output queue 
on disk; input from terminal 3 is sent to the output queues for terminal 4. 


7. — Defines the disk file for the queues. 
8. Defines static sessions as follows; 
CUP1 and CUP2 
CUP1 and TRM1 
CUP1 and TRM2 
TRM3 and TRM4 


Figure 3-14. Single-Node Standard Interface Global Network Definition 
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3.4.2. Single-Node Global Network with IMS and Local Workstations 


This network definition illustrates how to create an ICAM global network that 
supports several user programs and IMS. The network is all contained in a single 
node, (i.e., all programs and IMS are contained in the same host computer). Figure 
3-15 illustrates the logical arrangement of this global network, and Figure 3-16 shows 
the coding used to define it. 


The following are some pertinent characteristics of this network: 


e All the terminals are workstations, hence no single-line communications adapters 
are required. 


¢ There is only one workstation per communications line, because multiple 
workstations on the same communications line are not supported. 


* Only two static sessions are defined. These are between process file PRF1 and 
LOCAP file CUPP, and between LOCAP file CUPP and terminal TRM1. This 
means that user program CUPP can read from process file PRF1 and write to 
terminal TRM1 without needing to create a dynamic session. All input from 
TRM1 is automatically queued to process file PRF1 by ICAM. It also means that 
user program CUPP is the sole user of workstation TRM1, since no other user can 
access TRM1 due to the static session between CUPP and TRM1. 


¢ No queues are defined for LOCAP file IMS1. This is because IMS does not 
require a queued interface - disk buffering is used. 





¢ Only one workstation (TRM1) specifies an input destination. All the other 
workstations communicate with the user-written programs or IMS by using 
dynamic sessions. For example, when you are at a terminal and you need to talk 
to a program, you sign on with a $$SON command and ICAM creates the 
dynamic session between your terminal and the program, if possible. (The 
program or ICAM may reject the sign-on request for some reason, for example, 
the program you requested was not loaded.) If the session command is honored, 
the destination you supplied in the sign-on request is used, and no destination for 
input is needed in the network definition. If the session is rejected, a SESSION 
PATH CLOSED message is sent to your terminal. 


A user program issuing a SESCON macro to accept a session with a terminal 
always has the capability to specify the destination where input from a terminal 
is to be placed. The user program does this by specifying it in the INQNAME= 
operand in the SESCON macro. The SESCON macro is described in the ICAM 
Standard MCP Interface Programming Guide (UP-8550). 


¢ All the workstations can use interactive services, but they do so directly without 
the need of an ICAM network. 
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Figure 3-15. Global Network Supporting Workstations, IMS, and User-Written Programs 
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1. |C@07 CCA TYPE=(GBL,,A),FEATURES=(OPCOM) , GAWAKE=YES 
2. BUFFERS 20,512,2,ARP=42,STAT=YES, EXPFACT=50 
3.]1MS1 LOCAP TYPE=(TCI) 
4. |CUPN LOCAP TYPE=(STOMCP)LOW=MAIN 
CUPO LOCAP TYPE=(STDMCP)LOW=MAIN 
CUPP LOCAP TYPE=(STDMCP)LOW=MAIN 
5.|LNE1 LINE DEVICE=(LWS),STATS=YES 
6./TRM1 TERM FEATURES=(U2@) ,ADDR=(315) ,LOW=MAIN, X 
HIGH=MAIN, INPUT=PRF 1 
7.)LNE2 LINE DEVICE=(LWS),STATS=YES 
8. | TRM2 TERM FEATURES=(U2@) ,ADDR=(316) ,LOW=MAIN, HIGH=MAIN 
9. |LNES LINE DEVICE=(LWS),STATS=YES 
10. | TRM3 TERM FEATURES=(U2Q) ,ADDR=(317) ,LOW=MAIN, HIGH=MAIN 
11. | LNE4 LINE DEVICE=(LWS),STATS=YES 
12.1 TRM4 TERM FEATURES=(U2@) ,ADDR=(318) , LOW=MAIN, HIGH=MAIN 
13.|PRF1 PRCS LOW=MAIN 







-|TCIFILE DISCFILE MSGSIZE=2048 
SESSION EU1=(CUPP) , EU2=(TRM1) 
SESSION EU1=(PRF1),EU2=(CUPP) 
ENDCCA 

MCP 

MCPNAME=C3 







END 






1. Specifies a global network that includes operator communications and dynamic session capabilities. 

2. Specifies that 20 network buffers, each 512 words (2048 bytes) long, are required to service this network. A 
threshold of 2 network buffers is maintained by ICAM, and ICAM maintains statistics on network buffer and 
activity request packet (ARP) usage. ICAM will expand buffer pools automatically by 50% when needed. 

3. Specifies a LOCAP file named IMS1. This file is used by IMS. 

4. Defines three LOCAP files for use by standard interface programs. 


5. Specifies communications line LNE1 uses workstation protocol, and ICAM is to gather statistics. 


6. Specifies workstation TRM1 is attached to address 315. Low and high priority output queues are required, 
and input is directed to process file PRF1. 


7. Specifies communications line LNE2 uses workstation protocol, and ICAM is to gather statistics. 
8. Specifies workstation TRM2 is attached to address 316. Low and high priority output queues are required. 
9. Specifies communications line LNE3 uses workstation protocol, and ICAM is to gather statistics. 


Figure 3-15. Global Network Definition to Support Workstations, IMS, and User-Written 
Programs (Part 1 of 2) 
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10. Specifies workstation TRM3 is attached to address 317. Low and high priority output queues are required. 
11. Specifies communications line LNE4 uses workstation protocol, and ICAM is to gather statistics. 

12. Specifies workstation TRM4 is attached to address 318. Low and high priority output queues are required. 
13. Defines a process file for use by user program CUPP. 

14. Defines a disk file for IMS disk buffering requirements. 

15. Defines a static session wee LOCAP file CUPP and workstation TRM1. 

16. Defines a static session between process file PRF1 and LOCAP file CUPP. 

17. Ends this network definition. 

18. Specifies that this network definition is to be saved as a symbiont called C3. 


Figure 3-16. Global Network Definition to Support Workstations, IMS, and User-Written 
Programs (Part 2 of 2) 


3.4.3. Single-Node Global Network with IMS and Terminals Using 
Interactive Services 


User-written programs, IMS, and interactive services can coexist in the same 
communications network. In this single-node example, all of the terminals and 
programs reside in the same computer. The text describes some of the schemes that 
may not be completely obvious from the coding. 


About the Programs: 


Figure 3-17 illustrates the arrangement, and Figure 3-18 shows the coding used to 
define the network. In both figures, we assume that IMS uses LOCAP file IMS1, the 
user program uses LOCAP file CUPB, and interactive services uses LOCAP file DMI 
as their links to ICAM. 


Figure 3-17 shows the use of multiple program support by an ICAM global network. 
Workstations are used as terminals communicating with IMS and user-written 
programs. In addition, terminals are shown communicating with interactive services. 


About the Terminals: 


Of the eight terminals supported in this ICAM network, three are local workstations, 
three are UNISCOPE terminals, and two are UTS 400 terminals. In addition, one 
process file for CUPB and one disk file for IMS are defined. If IMS is required to 
support unsolicited or continuous output, a second process file with a static session 
would be required; since there is no static session defined for PRF1, we know that it 
was defined for use by CUPB. All other moshage traffic handled by ICAM is queued 
and stored in main storage. 
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Figure 3-17. Global Network Supporting IMS, User-Written Program, and Interactive Services 
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About Sessions: 


In addition to the mix of programs, terminals, and workstations, Figures 3-17 and 
3-18 illustrate the use of both static and dynamic sessions. For example, if you look at 
the SESSION macros in Figure 3-18, you will see that the following end users are 
linked by static sessions: LOCAP file IMS1 and workstation T312, LOCAP file CUPB 
and terminal TRM1, and LOCAP file CUPB and terminal TRM3. These SESSION 
macros create permanent links between these end users as long as the network is 
active. 


A SESSION macro defines a static session. Each terminal specified in a SESSION 
macro can only communicate with the end user specified in that static session; and no 
other end user can communicate with that terminal by using a dynamic session or by 
specifying another static session. ICAM will not create a dynamic session between 
end users when a session is already active; and a static session is always active. 


Terminal users using static sessions do not need to sign on and specify with whom 
they need to communicate; and user programs do not need to dynamically establish 
sessions with these terminals because the sessions are already permanently created in 
the ICAM network. Therefore, if a certain terminal is always going to communicate 
with the same program, and no others, you might consider the use of a static session. 
Whether you use dynamic or static sessions depends strictly on your needs. 


The other terminals in this example use dynamic sessions. A program using dynamic 
sessions wishing to communicate with another end user must initiate session requests 
in order to communicate with that end user, and terminal users must sign-on and 
specify the end user with whom they wish to communicate. Dynamic sessions provide 
a greater degree of flexibility in a communications network; however, they require 
additional coding in your program to initiate and terminate the dynamic sessions. 


When you examine Figures 3-17 and 3-18 closely, you'll notice relationships that we 
describe in the following paragraphs. We hope that the descriptions make it easier for 
you to define your global network. 


How End Users Communicate: 


¢ Local workstation T311 is a UTS 20 terminal that communicates with IMS or 
user program CUPB using dynamic sessions. When the workstation operator 
signs on or program CUPB requests a session, ICAM creates the dynamic session 
between the two end users. Workstation T311 is automatically attached to 
interactive services through a LOGON command. 


When your program initiates a dynamic session between itself and a terminal, it 
can access input from the location specified by the INPUT= operand in the TERM 
macro, or it can explicitly specify where input from the terminal is to be queued 
for its own purposes. You do this in your program by specifying the new 
destination in the INQNAME= operand described in the SESCON macro. (The > 
SESCON macro can be found in the ICAM Standard MCP Interface 
Programming Guide (UP-8550).) Note that when you specify INQNAME= in 
your program, it always overrides the INPUT= operand specified in the network 
definition TERM macro. 
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Workstation T312 is a UTS 20 terminal that communicates with IMS when 
ICAM is loaded and attached to the global network. Terminal T312 cannot 
communicate with user program CUPB because it is linked to IMS by a static 
session. Because input queuing is not required with IMS, the INPUT= operand is 
not specified. Workstation T312 is automatically attached to interactive services 
through a LOGON command. 


Workstation TRM1 communicates with CUPB using the static session defined for 
it. All input from TRM1 is queued directly to the low priority queue of LOCAP 
file CUPB. When it is not in use with CUPB, workstation TRM1 may 
communicate with interactive services through a LOGON command. 


UNISCOPE terminal TRM5 can communicate with IMS and user program 
CUPB. In addition, because TCTUPD=YES is specified, TRM5 can also 
communicate with interactive services. Dynamic sessions are used to permit 
communication. 


Because an input message queue is specified (INPUT=YES), your program 
obtains input messages from the queue unless your program changes the 
destination of input messages when it requests the dynamic session (as described 
for T311). Because interactive services doesn’t use a queued interface and IMS 
uses disk buffering for input, INPUT= in the TERM macro has no meaning for 
them. 


UNISCOPE terminal TRM2 can communicate with IMS and user program 
CUPB. Terminal TRM2 cannot communicate with interactive services because 
TCTUPD=YES is not specified; hence the software needed to access interactive 
services is not provided for this nonworkstation terminal. Because an input 
queue was established by the INPUT=YES operand in the TERM macro, your 
program accesses input messages from this queue unless it redefines a 
destination for input messages as described for terminal T311. INPUT= has no 
meaning for IMS. 


UNISCOPE terminal TRM3 and CUPB are linked by a static session, and all 
input from terminal TRM3 is queued to LOCAP file CUPB for user program 
CUPB. This essentially dedicates TRM3 to CUPB. 


UTS 400 terminal TRM6 may communicate with IMS, CUPB, or interactive 
services using dynamic sessions. This terminal also supports additional auxiliary 
devices. INPUT=YES specifies that input from this terminal is queued to an 
input message queue, however, input can be redirected by your program when it 
requests the dynamic session. INPUT= has no meaning for IMS or interactive 
services. 


UTS 400 terminal TRM4 may communicate with any program except interactive 
services. INPUT=YES specifies that input from this terminal is queued to an 
input message queue, however, input can be redirected by your program when it 
requests the dynamic session. INPUT= has no meaning for IMS. 
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1.|GBL1 CCA _—«TYPE=(GBL, ,S) , FEATURES=(OPCOM, OUTDELV), X 
FEATURES=(RESTART , SEGMENTS) , X 
GAWAKE=YES 

2. BUFFERS 100,64,5, ARP=100, EXPFACT=50 

3.}IMS1 LOCAP TYPE=(TCI) 

4. {DMI LOCAP TYPE=(DMI), IAS=(YES, OFF) 

5. | CUPB LOCAP TYPE=(STDMCP), LOW=MAIN, MEDIUM=MAIN , HIGH=MAIN 

6. | LNE@ LINE DEVICE=(LWS) , LBL=900 

7.17311 TERM ADDR=(311), FEATURES=(U20), INPUT=YES, X 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

8.(LNE1 . LINE DEVICE=(LWS),LBL=900 

9.|7312 TERM ADDR=(312) , FEATURES=(U2Q), X 


LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 
10. |LNE2 LINE DEVICE=(LWS),LBL=900 
11. |TRM1 TERM ADDR=(313) , FEATURES=(U2@) , INPUT=(CUPB), x 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
12. | LNE3 LINE DEVICE=(UNISCOPE) , TYPE=(9600, SYNC) , ID=8, STATS=YES 


13.) TRMS TERM FEATURES=(U20) ,ADDR=(21,51), INPUT=(YES), xX 
LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN, TCTUPD=YES 

14.1 TRM2 TERM FEATURES=(U2@),HIGH=MAIN,MEDIUM=MAIN, LOW=MAIN, x 
ADDR=(21,52), INPUT=(YES) 

15. | TRM3 TERM FEATURES=(U2@) ,HIGH=MAIN,MEDIUM=MAIN, LOW=MAIN, x 


ADDR=(21,55) , INPUT=( CUPB) 
16. | LNES LINE DEVICE=(UNISCOPE) , TYPE=(9600,SYNC) ,1D=9, STATS=YES 


17.1 TRM6 TERM —_— FEATURES=(U408, 1920) ,ADDR=(21,51), INPUT=(YES), x 
LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN, TCTUPD=YES, x 
AUX1=(TP, 73) ,AUX2=(TP,74) , AUX3=(TCS, 75,76) 

18. | TRM4 TERM —_ FEATURES=(U40@, 1920) , ADDR=(21,52), INPUT=(YES), X 
LOW=MAIN,MEDIUM=MAIN,HIGH=MAIN, x 
AUX 1=(TP,74) , AUX2=(TP, 73) , AUX3=(TCS, 75, 76) 

19. |PRF1 PRCS  LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

20.|TCIDTF DISCFILE MSGSIZE=2000 

21. SESSION EU1=(1MS1) ,£U2=(1312) 

22. SESSION EU1=(CUPB) , EU2=(TRM1) 

23. SESSION EU1=(TRM3) , EU2=(CUPB) 

24. |ENDCCA 

25. McP MCPNAME=M4 

26. CACH=(@8,GBL1,01) 


CACH=(89,GBL1,02) 
END 


Figure 3-18. Global Network Definition to Support IMS, User-Written Program, and Interactive 
Services (Part 1 of 3) 
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Notes: 


10. 


ll. 


12. 


13. 


Specifies a global network with operator communications and output delivery notice support. Disk queuing 
routines are included to enable warm restart, and segmented processing is supported. GAWAKE=YES 
specifies dynamic sessions support. 


Specifies 100 network buffers, each 64 words long (256 bytes each); sets a threshold of 5 network buffers; 
allocates 100 activity request packets for ICAM’s use; and requests a buffer pool expansion factor of 50%. 


Specifies a LOCAP file to support IMS. 


Specifies a LOCAP file to support interactive services. TYPE=DMI is specified because interactive services 
uses the demand mode interface to communicate with ICAM. IAS=(YES,OFF) means that interactive services 
is used without DICE functions. 


Specifies a LOCAP file to support a standard interface user program (CUPB). Three main storage queues are 
specified. 


Defines the first communications line in this network (LNEO). This line supports a workstation. A line buffer 
900 words (3600 bytes) long is also specified. 


Specifies a UTS 20 local workstation on address 311. FEATURES=(U20) identifies this terminal as a 
workstation. Notice that workstations are single station terminals (i.e., only one workstation is supported on a 
communications line). INPUT=YES means that an input message queue is set up to receive all messages from 
this workstation. Three output queues are also identified. 


Defines the second communications line in this network (LNE1). It supports a workstation and uses a line 
buffer 900 words long. 


Specifies a UTS 20 local workstation on address 312. An input message queue is not specified because this 
workstation supports IMS only using a dynamic session. Three output queues are specified. 


Defines the third communications line in this network (LNE2). It supports a workstation and uses a line buffer 
900 words long. 


Specifies a UTS 20 local workstation on address 313. All input to the host processor from this workstation is 
queued to the low priority queue of LOCAP file CUPB. 


Specifies the fourth line in this network (LNE3). It operates with UNISCOPE line protocol, line speed is 9600 
baud, and the transmission mode is synchronous. !D=8 identifies the single line communications adapter 
(SLCA) used. STATS-YES means that ICAM accumulates statistics for all terminals connected to this 
communications line. 


Defines the first of three.terminals (TRM5) connected to this communications line (LNE3). It is an SVT 1120 
terminal with a screen size of 1920 characters. Its rid,sid polling address is 21,51, and input from this 
terminal is queued to an input message queue. TCTUPD=YES means this terminal can communicate with 
interactive services. Three main storage output queues are defined. 


Figure 3-18, Global Network Definition to Support IMS, User-Written Program, and Interactive 


Services (Part 2 of 3) 


UP-9745 Rev. 3 














14, 


15. 


16. 


17. 


18. 


19. 
20. 
21. 
22. 
23. 
24. 
25. 


26. 


Defining Your Network 


Defines the second SVT 1120 terminal (TRM2) on this line. Three main storage output queues are specified; 
its rid,sid address is 21,52; and all input is queued to an input message queue. Because this terminal never 
needs to communicate with interactive services, TCTUPD=YES is not specified as it was for TRM5. 


Defines the third SVT 1120 terminal (TRM3) on this line. Three main storage output queues are specified; its 
rid,sid address is 21,55; and all input from this terminal is placed on the low priority queue of locap file CUPB. 


Specifies the fifth communications line in this network (LNE4). The line is synchronous, runs at 9600 baud, 
and uses UNISCOPE line protocol. its SLCA number is 9 and ICAM collects statistics for all terminals 
connected to this fine. 


Defines a UTS 400 terminal with a screen size of 1920 characters. Its rid,sid polling address is 21,51, and 
all input to the host processor is placed on an input message queue. Three main storage output queues are 
required. TCTUPD=YES means that this terminal can communicate with interactive services. It also supports 
a tape cassette unit. 


Defines a UTS 400 terminal with a screen size of 1920 characters. Its rid,sid polling address is 21,52, and 
all of its input is placed on an input message queue. Three main storage output queues are required. It 
supports two terminal printers and a tape cassette unit. This terminal does not access interactive services. 


Defines a process file (PRF1) for use by CUPB. 

Defines a disk file for use by IMS. 

Defines a static session between LOCAP file IMS1 and workstation T312. 

Defines a static session between LOCAP file CUPB and workstation TRM1. 

Defines a static session between terminal TRM3 and locap file CUPB. 

ENDCCA specifies the end of this network defintion. 

MCPNAME.=Mé4 specifies the name of the symbiont where this ICAM network is stored. 

CACH statements are sytem generation parameters and are discussed more fully in the Installation Guide, 
UP-8839. These CACH statements specify the SLCA. GBL1 is the name of the network or communications 
control area (CCA). Lines 04 and 05 in network GBL1 (the fourth and fifth LINE macros in the network 
defintion) are the first and second lines that are mapped to the SLCAs. (Local workstations are not connected 
to SLCAs; therefore, the CACH statement with relative line 1 maps with the LNE4 LINE macro and the one with 
relative line 2 maps with the LNE5 LINE macro. When the network is generated, ICAM uses this information to 


load the single line communications adapters with the correct code needed to service the communications 
lines specified. 


Figure 3-18. Global Network Definition to Support IMS, User-Written Program, and Interactive 
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3.4.4. Single-Node Global Network with Remote Workstations 


This network definition illustrates how to create a single-node global network that 
supports remote workstations. Figure 3-19 shows the logical arrangement of the 
network, and Figure 3-20 shows how to define it. These are the most significant 
characteristics of this network: 


e¢ You must specify DCA=YES in the CCA macro. 
¢ You must specify UDUCT and LINKPAK parameters on the BUFFERS macro. 


¢ All remote workstations are connected via synchronous line adapters. Multiple 
workstations may be attached to a line. 


¢ You must specify DEVICE=(RWS) and TYPE=(SYNC) for the LINE macro. 


¢ You identify a terminal as a remote workstation on the FEATURES operand of 
the TERM macro. You can use UTS 20/30/40, PC with STEP, or SVT 1123/1124 
terminals as remote workstations. These terminals must be hardware configured 
as single station terminals (not workstations configured for cluster controllers). 


* You must classify remote workstations into polling groups. To do this, precede 
the TERM macros (that identify the remote workstations) you want ina 
particular polling group with a PGROUP macro. 





¢ You can operate a remote workstation in two modes: system mode or workstation 
mode. When you first log on a workstation, the workstation is initially placed in 
workstation mode. To establish an ICAM dynamic session to a terminal or user 
program, enter a $$SON (sign-on) command (see 6.2.1). To perform a system 
function, such as interactive services, you press the FUNCTION and SYS (system 
mode) keys simultaneously. 


System mode allows you to perform system type operations such as using 
interactive services, job control processing, entering system commands, and 
responding to system messages. Workstation mode allows you to sign on to 
ICAM for communications with IMS or standard interface user programs. 


When you define a network to use remote workstations, you must define a 
LOCAP file as TYPE=DMI and MODE=SYSTEM. If you are going to operate in 
workstation mode to communicate with ICAM, define a LOCAP file with 
TYPE=TCI for IMS or TYPE=STDMCP for standard interface user programs. 
Multiple LOCAP files may be specified for multiple user program applications, 
but only one system mode LOCAP file may be specified per network. Note that 
remote workstatians cannot be used for multinode operations. 
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1. | RWSA CCA TYPE=(GBL, ,A), FEATURES=(OPCOM), x 
GAWAKE=YES , DCA=YES 

2. BUFFERS 200,64,0,ARP=50,STAT=YES, x 
UDUCT=(16, 28,2) , LINKPAK=(24,80,3) 

3./1AS1 LOCAP TYPE=(DMI) ,MODE=SYSTEM, IAS=(YES, OFF) 

4.|CUP1 LOCAP TYPE=(STDMCP), LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

5./LNO1 LINE DEVICE=(RWS)TYPE=(960, SWCH, SYNC), ID=8,RETRY=(6,4) 

6. PGROUP PGID=28 

7.|TMO1 TERM FEATURES=(U2@, 1920) , ADDR=(28,51),HIGH=MAIN, x 
MEDIUM=MAIN, LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 

8. | TMO2 TERM FEATURES=(U2@, 1920) ,ADDR=(28,52) ,HIGH=MAIN, x 
MED IUM=MAIN , LOW=MAIN, AUX 1=(COP, 73) , AUX2=(TP,74) 

9. PGROUP PGID=28 

10. | TMO3 TERM FEATURES=(U2@) ,ADDR=(29,51) ,HIGH=MAIN, x 
MEDIUM=MAIN, LOW=MAIN, AUX 1=(COP, 73) , AUX2=(TP, 74) 

11. | TM@2 TERM FEATURES=(U2@,962) ,ADDR=(29,52) ,HIGH=MAIN, X 
MEDIUM=MAIN, LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 

12. |LNO2 LINE DEVICE=(RWS) , TYPE=(9600, SWCH, SYNC) , ID=9 

13. PGROUP PGID=28,PTIME=(1,60) 

14./TTO1 TERM FEATURES=(U4@,, ,PRIMARY) ,ADDR=(28,51) ,HIGH=MAIN, x 
MEDIUM=MAIN , LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 

15.|TTe2 TERM FEATURES=(U40,, , SECONDARY) , ADDR=(28,52) ,HIGH=MAIN, x 
MEDIUM=MAIN, LOW=MAIN, AUX 1=(COP, 73) , AUX2=(TP, 74) 

16. PGROUP PGID=29,PTIME=(4,68) 

17.|TT@3 TERM FEATURES=(U4,, ,PRIMARY) ,ADDR=(29,51),HIGH=MAIN, Xx 
MEDIUM=MAIN, LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 

18.|TTO4 TERM FEATURES=(U4Q,, , SECONDARY) , ADDR=(29,52) ,HIGH=MAIN, x 
MEDIUM=MAIN, LOW=MAIN, AUX1=(COP, 73) , AUX2=(TP, 74) 

ENDCCA 


1. Specifies a singlenode global network using distributed communications architecture that includes operator 
communications and dynamic session capabilities. a 


2. Specifies 200 network buffers, each 64 words (256 bytes) long. Statistics are to be maintained. Distributed 
data processing data unit contro! tables and link buffers are included. 


3. Specifies a LOCAP file named IAS1 is used for system mode interactive services. Priority queues are not 
specified because interactive services uses the DMI interface to communicate with end users, and queuing 
does not apply in this interface. 


4. — Specifies a LOCAP file named CUP1. It is used to enable a remote workstation (in workstation mode) to 
communicate with a user program. Because communications is via the standard interface, queues are 
required. We specified three: low, medium, and high. 


5. Specifies that communications line LNO1 services remote workstations. It is connected to SLCA 8 (ID=8). 


Figure 3-20. Global Network Supporting Remote Workstations and System Mode of 
Operations (Part 1 of 2) 





3-44 UP-9745 Rev. 3 


Defining Your Network 








10. 


iy. 
12. 


13. 
& 14. 
15. 
16. 
17. 


18. 


Specifies that the following workstations (TMO1 and TMO2) belong to this polling group (rid 28). This poll 
group uses a default value of 1 xsecond for a normal poll interval and 60 seconds for a slow poll interval. 


Specifies that remote workstation TMO1 is a UTS 20 terminal with a screen size of 1920 characters. Low, 
medium, and high priority queues reside in main storage. A communications output printer (COP) and a 


terminal printer (TP) are the auxiliary devices. 


Specifies that remote workstation TMO2 is a UTS 20 terminal. All of the parameters are the same as for 7 
except in the ADDR operand. 


Specifies that the following workstations (TMO3 and TMO4) belong to a new poll group. The polling interval is 
specified as 2 seconds for normal poll and 60 seconds for a slow poll. 


Specifies that remote workstation TMO3 is a UTS 20 terminal with default screen size of 1920 characters. 
The remaining parameters are the same as for 7 and 8 except in the ADDR operand. 


Specifies that remote workstation TM04 is a UTS 20 terminal with a screen size of 960 characters. 
Specifies that communications line LNO2 services remote workstations. 


Specifies that the following workstations (TTO1 and TT02) belong to the same polling group as specified in 6, 
and explicitly states the normal and slow polling time intervals. 


Specifies that remote workstation communications is with the primary screen of a UTS 40 remote 
workstation. The default designates a screen size of 1920 characters. 


Specifies that remote workstation communications is with the secondary screen of a UTS 40. All other 
parameters are the same as for 14 except in the ADDR operand. 


Specifies that the following workstations (TT03 and TT04) belong to a new polling group (rid 29). It specifies a 
different normal polling interval of 4 seconds and a slow polling interval of 60 seconds. 


Specifies that remote workstation communications is with the primary screen of a UTS 40 remote 
workstation. 


Specifies that remote workstation communications is with the secondary screen of a UTS 40 remote 
workstation. 


Figure 3-20. Global Network Supporting Remote Workstations and System Mode of 
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DCA Global Networks 


DCA global networks can be configured as multinode networks to support user- 
written programs that use the standard interface, information management system 
(IMS), interactive services, or distributed data processing (DDP). DCA global 
networks also support most public data networks (PDNs) and distributed 
communications processors (DCPs). 


DCA multinode global networks require the use of dynamic sessions. The 
GAWAKE<=YES and DCA=YES operands must be specified in the CCA macro to 
permit dynamic session establishment/disestablishment requests from a remote 
terminal or remote computer node. The SESSION macro is not used, since it defines 
end users for static sessions only. Instead, the GAWAKE macro enables your program 
to be awakened and receive datagrams; the SESCON macro enables your program to 
dynamically request (or accept) the establishment of a dynamic session. 


You must define a LOCAP file (via the LOCAP macro) for all DCA applications as 
follows: 


e Standard interface user program - specify TYPE=(STDMCP) 
¢ IMS programs - specify TYPE=(TCI) 
¢ Interactive services and distributed data processing - specify TYPE=(DMD 


When DCPs are used in DCA networks, interactive terminals can be used in the 
standard interface or the transaction interface (IMS) or demand mode interface 
(DMD). 


Distributed communications processors are controlled by the Telcon communications 
network subsystem software. The ICAM network definition must therefore match 
certain labels and parameters of the configuration statements used to generate the 
Telcon network. See Appendix A for detailed information on relating Telcon and 
ICAM networks. : 


The DVCGID and REMOTE operands of TERM macros are used for all remote 
terminals in a DCA multinode network. The PROTYP operand of a TERM macro 
defaults to DEV for a DCA multinode network. 


The REMOTE operand of a LOCAP macro is used for all remote LOCAPs in a DCA 
multinode network. 


Virtual lines (VLINEs) for all these DCA multinode configurations are UDLC 
asynchronous balanced mode (ABM). Logical ports, defined by the LPORT macro, are 
used for all DCA networks with the exception of public data networks to specify the 
remote session end user ports. 
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Summarizing all the multinode DCA configurations, except the public data networks 
and DCPs, the ICAM network definitions would include the following: 


DCA DCA DCA 
Standard IMS Is/DoP 
CCA TYPE= (GBL, ,node) (GBL, ,node) (GBL, ,node) 
DCA= YES YES YES 
GAWAKE= YES YES YES 
VLINE DEVICE= ABM ABM ABM 
LOCAP TYPE= (STDMCP) (TCI) (DMI) 
TERM 
LPORT USERTP= STDMCP TCI DMI 


Multinode DCA global networks also support all circuit-switched and packet-switched 
public data networks, except DATEX-L. (See 3.6.) 


Table 3-2 summarizes the basic differences in specifying network definitions for 
dedicated, single-node global and DCA global network configurations. 


Figures 3-21 through 3-27 show multinode global networks with various distributed 


communications architecture configurations. The shaded operands illustrate the basic 
differences in the configurations. 
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NODE A NODE B 
fee tee 
1 72 





1. {ACT1 CCA TYPE=(GBL, ,A) ,DCA=YES, GAWAKE=YES 
2. BUFFERS 24,64,2,ARP=36, xX 
UDUCT=( 12, 28,3), LINKPAK=(45 , 80,6) 
3. |CUP1 LOCAP TYPE=(DMI), IAS=(YES,OFF) 
4. |VLN1 VLINE DEVICE=ABM, TYPE=(96@0) , 1D=9, CMDADDR=3 , RSPADDR=1 
5. LPORT LINE=VLN1,REMOTE=B,PORT=1,EU1=CUP1,EU2=CUP2, X 
USERTP=DMI 
6. |CuPp2 LOCAP TYPE=(DMI),REMOTE=(B) 
ENDCCA 
MCP 
MCPVOL=REL 130 
MCPNAME=C1 
7. CACH=(09, 9600, FULL, ILA) 


END 


1. DCA global network with a dynamic session capability. 





2. Specifies the buffering requirements to support DCA and DDP. 
3. Specifies a LOCAP file (TYPE=DMl) defined to support distributed data processing environment. 


4. Specifies a virtual line with asynchronous balanced mode (ABM) link to a remote node in a distributed 
data processing environment. 


5. Port 1 for the logical port with demand mode interface sessions between user programs CUP1 and 
CUP2. ; 


6. Definition of the remote LOCAP file {in the other computer) using distributed data processing. 


7. Defines line used by VLN1. Virtual line is full duplex with intelligent line adapter. 


Figure 3-21. DCA Multinode Network Definition for Distributed Data Processing 
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1 72 
Gvc2 CCA TYPE=(GBL, , NODA) , GAWAKE=YES , DCA=YES 
BUFFERS 50,64,0,ARP=205, x 
UDUCT=(48, 28,3) , LINKPAK=( 100,88, 15) 
DOP 1 LOCAP =‘ TYPE=(DMI), IAS=(YES, OFF) 
SLO2 LOCAP —‘ TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
VLNG VLINE  DEVICE=ABM, ID=8, TYPE=(960), x 
CMDADDR=3, RSPADDR=1 
LPORT  EU1=DDP1,EU2=DDP2,USERTP=DMI , CATP=C, LINE=VLNG, Xx 
REMOTE=NODB, PORT=1 
LPORT  EU1=SL02, EU2=TA16, USERTP=STDMCP, CATP=C, LINE=VLNG, x 
REMOTE=NODB, PORT=2 
LPORT — EU1=DDP1,EU2=TA16,USERTP=DMI , CATP=C, LINE=VLNG, Xx 
REMOTE=NODB , PORT=3 





TA16 TERM FEATURES=(U200, 1920) , PRI EV DVCGIDAINTS3, Xx 
LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN, INPUT=YES, x 
REMOTE=(NO 






DDP2 LOCAP TYPE=(OMI), 


ENDCCA 

MCP MCPNAME=C6 
CACH=(08,9600, FULL, ILA) 
END 


Figure 3-22. Multinode Distributed Data Processing with Interactive Terminal 
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NODE A 











1 72 
Gvc2 CCA YYPE=(GBL, ,NODA) , GAWAKE=YES , DCA=YES 
BUFFERS 50,64,0,ARP=205, X 
UDUCT=(40,28, 3), LINKPAK=( 108, 80, 15) 
DDP1 LOCAP =‘ TYPE=(DMI), IAS=(YES, OFF) 
SLe2 LOCAP =‘ TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
VLN4 VLINE  DEVICE=ABM, 1D=08, TYPE=(9600), Xx 
CMDADDR=3,RSPADDR=1 
LPORT  EU1=DDP1,USERTP=DMI ,CATP=C, LINE=VLNG, Xx 
REMOTE=DCP4 , PORT=1 
LPORT  EU1=SL@2,USERTP=STDMCP, CATP=C, LINE=VLNG, X 
REM 4 , PORT=2 
TA16 TERM FEATURES=(U20@, 1920) , PROTYP=INT- 1, DVCGID=INT33, x 
LOW=MAIN , MEDIUM=MAIN ,HIGH=MAIN, INPUT=YES , REMOTE=(DCP4) 
ENDCCA 
MCP MCPNAME=C6 
CACH=(08,960@, FULL, ILA) 
END 


Figure 3-23. Interactive Terminal with Distributed Communications Processor (DCP) 
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Gvc2 CCA TYPE=(GBL, , NODA) , GAWAKE=YES, DCA=YES 
BUFFERS 50,64,0,ARP=205, x 
UDUCT=(40, 28,3) , LINKPAK=( 100,80, 15) 
DDP1 LOCAP TYPE=(DMI), IAS=(YES, OFF) 
$L02 LOCAP TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 
VLNG VLINE DEVICE=ABM, ID=08, TYPE=(9600), x 
CMDADDR=3,RSPADDR=1 
LPORT EU1=DDP1,EU2=DDP2,USERTP=DMI , CATP=C, LINE=VLNG, X 
REMOTE=NODB, PORT=1 
LPORT EU1=SL02,EU2=TA16,USERTP=STDMCP, CATP=C, LINE=VLN4, X 
REMOTE=NODB, PORT=2 
LPORT EU1=DDP1,EU2=TA16,USERTP=DMI , CATP=C, LINE=VLNG, x 
REMOTE=NODB, PORT=3 
TAI6 TERM FEATURES=(U200, 1920) ERE EV, DVEGI x 





ppP2 LOCAP TYPE= (OMI, REMOT. 
SLQ1 LOCAP idiot tat ia LOW=MAIN, MEDIUM= MAIN, HIGH=MAIN, x 





ENDCCA 

MCP MCPNAME=C6 
CACH=(28, 9600, FULL, ILA) 
END 


Figure 3-24. Distributed Data Processing with a Distributed Communications Processor as an 
Intermediate Node 
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NODE 1 NODE 2 


APL4 
(18/5808) 





1. [NRP2 CCA TYPE=(GBL, ,NOD1) , DCA=YES, GAWAKE=YES, CCAID=UDLC-NRM, x 
FEATURES=(OPCOM) 

2. BUFFERS 10@,80,3,ARP=50,STAT=YES,UDUCT=(40, 28,2), x 
LINKPAK=(70, 80,5), RTIMER=10 

3. |APL3 LOCAP TYPE=(DMI), IAS=(YES,OFF), x 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

4. |CGR1 CONGRP CAT=A,TYPE=(UDLC ,DCA2) , CONNTYP=( ,AUTO) 

5. |VLN1 VLINE DEVICE=(NRM), TYPE=(4800), x 
CHAN=15, ID=18, TIMEOUT=( 180, 20) 

6. {STA STATION TYPE=(TWA, PRIMARY) ,WINDOW=7,MAXIFLD=255, xX 
LINE=VLN1 

7. |STA2 STATION TYPE=(TWA, SECONDARY) ,WINDOW=7 ,MAXIFLD=255, xX 
REMOTE=NOD2,, ADDRESS=03 

8. LPORT EU1=APL3,EU2=APL4,USERTP=DMI , CATP=C, LINE=VLN1, xX 
REMOTE=NOD2, PORT=2 

9. |APL4 LOCAP TYPE=(DMI),LOW=MAIN,MEDIUM=MAIN,HIGH=MAIN, - x 
REMOTE=(NOD2) 

10. CGRPEND 

ENDCCA 


MCP = MCPNAME=M1 
CACH=( 10,4800, ILA), CHAN=15 
END 
1. DCA global network with a dynamic session capability. 
2. — Specifies the buffering requirements to support DCA and DDP. * 
3. Specifies a LOCAP file (TYPE =DMl) defined to support distributed data processing environment. 
4. Indicates a normal response mode (NRM) connection utilizing DCA level 2 communications. 
5. Specifies a virtual line with an NRM link to a remote node in a distributed data processing environment. 
6. Defines this computer node as the primary station for the applicable VLINE (VLN1). 
7. Defines NOD2 as containing the secondary station. 
8. Defines the end users and remote site. 
9. Specifies the remote LOCAP. 


10. Indicates the end of the CONGRP. 


Figure 3-25. DCA Network Using NRM to Transfer Files between an OS/3 and a UNIX 0/S 
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COMMCT 

JER1 “CCA —« TYPE=(GBL, ,NOD1) ,DCA=YES, GAWAKE=YES, CCAID=UDLC-NRM, X 
FEATURES=(OPCOM) 

BUFFERS 100,80,3,ARP=58, STAT=YES,UDUCT=(40, 28,2), Xx 

LINKPAK=(78,80,5) ,RTIMER=10 

APL3 LOCAP TYPE=(DMI), IAS=(YES,OFF), x 
LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

CGR1 CONGRP CAT=A, TYPE=(UDLC,DCA2) , CONN 






VLN1 VLINE DEVICE=(NRM), TYPE=(2400, SWCH,QNAT: 
CHAN=15, ID=10, T IMEOUT=( 180, 20) 
STA1 STATION TYPE=(TWA, PRIMARY) ,WINDOW=7 ,MAXIFLD=255, x 
LINE=VLN1 
STA2 STATION TYPE=(TWA, SECONDARY) , WINDOW=7 ,MAXIFLD=255, xX 
REMOTE=NOD2 , ADDRESS=03 
LPORT EU1=APL3,EU2=APL4,USERTP=DMI ,CATP=C,LINE=VLN1, xX 
REMOTE=NOD2, PORT=2 
APLS LOCAP TYPE=(DMI),LOW=MAIN,MEOIUM=MAIN, HIGH=MAIN, x 
REMOTE=(NOD2) 
CGRPEND 
ENDCCA 
mMcP MCPNAME=C5 
@ CACH=(10,2400, SWITCHED, ILA) , CHAN=15 
END 


Figure 3-26. DCA Network Using NRM to Transfer Files between an OS/3 and a UNIX 0/S 
Using a Switched Line 
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UNIX O/S O/S 3 





ASYN CCA —s TYPE=(GBL, ,N) , EATURES=(OPCOM, OUTDELV) 
BUFFERS 30,256,3,ARP=30, STAT=YES 
UNX@ LOCAP TYPE=(STDMCP), LOW=MAIN, DUSTERR=INLINE 
ASY1 LINE DEVICE=(TTYEM), ID=6, TYPE=(4800, FLDQ, FULL) 
UX@e TERM FEATURES=(TTYEM), INPUT=(YES) , LOW=MAIN, x 


DICE=(OFF) ,XLATE=(NO,NO) 
SESSION PRIMARY, EU1=(UNX@@, EU2=(UX@Q) 
ENDCCA 
McP MCPNAME=C1 
CACH=(06,ASYN, 01) 


» {END 


Signals the start of an ICAM generation. 

DCA global network. 

Specifies the buffering requirements. 

Specifies the LOCAP name. A maximum of 10 LOCAPs may be specified. Each must have an 
associated LINE specified, and each LINE must have an associated TERM specified. LOCAP names 
must be UNXO through UNX9, 

Specifies a full duplex asynchronous line using the TTYEM handler. Full duplex must be specified. 
Specifies the terminal name indicating TTYEM. The TERM names must be UXO0 through UX09. 
Establishes a static session between the LOCAP and the terminal. 

Indicates the end of the ICAM network generation. 

Indicates the name of the ICAM network and specifies the channel hardware assignments. 


Indicates the end of the ICAM generation. 


Figure 3-27. OS/3 to UNIX O/S Connectivity: SVT Emulation 
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3.6. Programming ICAM for Public Data Networks 


When a public data network (PDN) is the communication service that you are using 
for System 80, write your ICAM network definition to meet the PDN requirements. 


ICAM supports the following circuit-switched and packet-switched public data 
networks, all of which require a global DCA network except DATEX-L. The DATEX-L 


PDN is described in 3.6.3. 
Circuit-Switched Packet-Switched 
Networks Networks 
NORDIC- Denmark, Finland, DATAPAC - Canada 
Norway, Sweden DATEX-P - West Germany 
DATEX-L- West Germany DDX - Japan 


IBERPAC - Spain 
PSS - United Kingdom 
TRANSPAC - France 


In all public data networks, except DATEX-L, the local resources are defined first via 
the LINE, TERM, and LOCAP macros. The PDN macro then declares the start of a 
public data network definition and specifies the carrier and type (circuit- or packet- 
switched). The associated virtual line (VLINE) follows with its appropriate protocol: 
UDLC asynchronous balanced mode (ABM) for circuit-switched PDNs, or link access 
procedure A or B (LAPA/LAPB) for packet-switched PDNs. The protocol used 
depends on the public data network carrier you use. Following the VLINE macro, the 
macros unique to public data networks are specified according to their carrier type. 


In the network definitions that follow, only the public data network requirements are 
described, although other non-PDN communications devices might also be included in 
the same network. For example, an extensive ICAM network may support a public 
data network connection, some local workstations, several remote workstations, and a 
number of dial lines. However, ICAM cannot support both circuit-switched and 
packet-switched definitions in the same network. 


3.6.1. Circuit-Switched Public Data Networks 


The circuit-switched PDN establishes a dedicated physical connection between two 
data terminal equipments (DTE), your System 80 computers, for the transmission of a 
single message. The PDN interface units between the two DTEs are called data 
communication equipment (DCE). After the message is transmitted, the physical 
connection is cleared until a response to the message is available or a new message is 
ready for transmission. Circuit-switched PDNs establish and clear calls quickly. 


DATEX-L is the West German circuit-switched public data network. It requires an 
ICAM global network without DCA and is described in 3.6.3. 
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NORDIC is the X.21 circuit-switched public data network for Denmark, Finland, 
Norway, and Sweden. It requires an ICAM global network with DCA. ICAM supports 
two modes of service for NORDIC circuit-switched public data networks--computer to 
computer and computer to UTS 20X terminal. 


When you code your ICAM network definition for NORDIC (computer to computer), 
you need to describe the public data network and both the local data terminating 
equipment (LDTE) and remote data terminating equipment (RDTE). ICAM provides 
the following special macros to do this: 


These Macros: Describe: 

PDN The kind of public data network 

LDTE The attributes of a local data terminating equipment 
CPSTB A table of actions for call progress signals 

VLINE Some facts about the physical communications line to the 


PDN: where it is attached to your computer and what line 
protocol is used. 


RDTE The attributes of a remote data terminating equipment 





LPORT The characteristics and end users of the DCA logical port 
Table 3-6 provides an order of presentation of macros you should use when you code 
your circuit-switched public data network. 


Figure 3-28 shows two types of circuit-switched PDNs that ICAM supports: DATEX-L 
and NORDIC (computer to computer). 
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Table 3-6. Order of Presentation of Macros in a Network Definition for a Circuit-Switched PDN 


(Computer to Computer) 
Macro Remarks 
Description of Local (Non-PDN) Communications 
CCA Start of network definition 
BUFFERS Specifies system resources 
LOCAP 1-n Creates LOCAP files for local users 
LINE1 Describes the first local communications line 
TERM 1-n Describes the terminals on the first line 
LINEn Describes the last local communications line 
TERM 1-n Describes the terminals on the last line 
DISCFILE1 -n Specifies network disk files 
PRCS1-n Specifies local process files 
DLIST Specifies network distribution lists 
MPSTART1 -n Specifies start of MPPS statements 
Description of Circuit-Switched Equipment 
PDN Start of a circuit-switched environment 
LDTE1 Defines the attributes of the first local DTE in the network 
CPSTBI-n Defines a table of actions for ICAM if network cannot be established 
VLINE1 Describes the physical tink that connects this DTE to its DCE 
RDTE1 Defines the attributes of the first remote DTE in this network 
LPORT1-n Defines a logical port 
LOCAP] - n Defines any remote DTE programs (LOCAP files) 
TERM] - n Defines any remote DTE terminals 
PRCS1-n Defines any remote process files 
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Table 3-6. Order of Presentation of Macros in a Network Definition for a Circuit-Switched PDN 
(Computer to Computer) (cont.) 


Macro Remarks 
Description of Circuit-Switched Environment (cont.) 


LDTEn Defines the attributes of the last local DTE in the network 
CPSTB1-n Defines a table of actions for ICAM if network cannot be established 
VLINEn Describes the physical link that connects this DTE to its DCE 
RDTEn Defines the attributes of the last remote DTE in this network 
LPORT1 -n Defines a logical port 
LOCAP1 -n Defines any remote DTE programs (LOCAP files) 
TERMI -n Defines any remote DTE terminals 
PRCS1 -n Defines any remote process files 
ENDCCA Identifies end of ICAM network definition 
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Figure 3-28. Typical DATEX-L NORDIC Circuit-Switched PDN Environment (Computer to Computer) 
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Figure 3-29 shows the coding for the 2-node NORDIC circuit-switched public data 
network environment shown in Figure 3-28. Figure 3-30 shows the network definition 
for the local node(S), and Figure 3-31 shows the network definition for the remote 
node (T). Both nodes consist of System 80 computer systems. 


The first part of each network definition from CCA to PDN defines the network and 
describes the resources ICAM needs to support communications at the local node. 
This includes all locally connected terminals and locap files to support your programs. 
This part of the network description is much the same as one you might specify to 
support any global network. 


The part of the network definition beginning with the PDN macro defines the public 
data environment for ICAM. The PDN macro first identifies the network by type and 
name. The LDTE macro starts the definition of the interface between the public data 
network and the local node (System 80). With the ADDRESS= operand of LDTE, you 
can include the telephone number of the local node if you wish, but it is not required. 


If you define your own call progress signal table with the CPSTB macro, specify the 
label of the first CPSTB macro as shown in the examples. But, you don’t have to 
define your own call progress signal table; you can accept the default values listed in 
Table 2-3 that are provided by the system. If you accept the default values, you do not 
have to include any CPSTB macros in your network, and, therefore, you do not have to 
specify the label of a CPSTB macro in the LDTE macro. 


To complete the definition of the interface between the public data network and the 
local node, you describe the physical line using the operands of the VLINE macro. 
You can also define the nodes as primary or secondary with the VLINE operand 
DEVICE-. 





With the RDTE macro, you start defining the remote interface of the network by 
specifying the calling number (address) of the remote node followed by LPORT macros 
to specify all of the sessions between local and remote end users. Table 3-7 lists all of 
the local and remote end users defined in Figure 3-29 and all of the sessions specified. 


After defining the local and remote interfaces, the LOCAP, TERM, and PRCS macros 
are included in each network definition to describe the end users of the remote node. 


At the end of each network, storage areas, process (PRCS) and disc (DISCFILE) files, 
are specified. In Figure 3-30, the process file is included for the two local 
workstations, TRML and TRMW, and the TRMA terminal on line LNE5. The disk file 
GVD1 is specified for all standard interface local end users with sessions defined with 
a remote end user. The disk file TVD1 is specified for sessions using TCI (IMS users). 
Since the remote node (Figure 3-31) has no need for a process file, only disk files for 
standard interface (GV.D2) and IMS (TVD2) sessions are specified. 
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CCA  TYPE=(GBL,,S),GAWAKE=YES ,DCA=YES, 
FEATURES=(OPCOM, SEGMENTS , OUTDELV) 

BUFFERS 100,64,5,ARP=35, LINKPAK=(50,80, 10) ,UDUCT=(24, 28,3) 

LOCAP TYPE=(STDMCP) ,LOW=GVD1,MEDIUM=GVD1,HIGH=GVD1 

LOCAP TYPE=(TCI),LOW=GVD1,MEDIUM=GVD1,HIGH=GVD1 

LINE DEVICE=(UNISCOPE) ,LBL=256, TYPE=(2400, SWCH, SYNC) 

TERM ADDR=(28, 51), FEATURES=(U40@, 1920), 
LOW=GVD1, MEDIUM=GVD1, HIGH=GVD1, INPUT=(SL@2) 

TERM ADDR=(28,52) , FEATURES=(U400, 1920), 
LOW=GVD 1,MEDIUM=GVD 1, HIGH=GVD1, INPUT=(SL62) 

TERM ADOR=(28,53), FEATURES=(U40®, 1920), 
LOW=GVD1,MEDIUM=GVD1,HIGH=GVD1, INPUT=(SL@2) 

LINE DEVICE=(LWS), INPUT=YES 

TERM FEATURES=(U2@) , ADDR=(312) 

LINE DEVICE=(LWS), INPUT=YES 

TERM FEATURES=(U2@) , ADDR=(313), 
LOW=GVD1,MEDIUM=GV01,HIGH=GVD1 

LINE DEVICE=(UNISCOPE), LBL=256, TYPE=(2400,SWCH, SYNC) 

TERM FEATURES=(U400, 1920), INPUT=YES, ADDR=(28,51), 
LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

TERM FEATURES=(U40@, 1920), INPUT=(TLO2) , ADDR=(28,52), 
LOW=GVD1,MEDIUM=GVD1, HIGH=GV01 

TERM FEATURES=(U400, 1920), INPUT=(TLO2) , ADDR=(28,53), 
LOW=GVD1,MEDIUM=GVD1,HIGH=GVD1 

PDN ‘TYPE=CIRCUIT, CARRIER=NORDIC 

LDTE CPSTBL=TAB1 

CPSTB CPS=03, TBD=60 

CPSTB CPS=21,NOR=0, TBR=0 

CPSTB CPS=(20,44) ,NOR=5, TBR=5 

CPSTB CPS=61,NOR=(2, 10), TBR=( 10,60) 

CPSTB CPS=71,NOR=(, 10), TBR=(, 1800) ,END=TAB1 

VLINE DEVICE=ABM, TYPE=(9600,X21,SWCH) , 1D=15 

ROTE ADDRESS=1357999, TIMER=5 

LPORT EU1=SL01,EU2=SLO2,USERTP=STOMCP, CATP=C,LINE=LNEO, 
REMOTE=T, PORT=1 

LPORT EU1=TRM1,EU2=SL02,USERTP=STDMCP, CATP=C, LINE=LNEO, 
REMOTE=T, PORT=2 

LPORT EU1=TRM2, EU2=SLO2, USERTP=STDMCP, CATP=C, LINE=LNEO, 
REMOTE=T , PORT=3 

LPORT EU1=TRM3,EU2=SLO2,USERTP=STOMCP, CATP=C,LINE=LNEO, 
REMOTE=T, PORT=4 

LPORT EU1=TL01,EU2=TLO2,USERTP=TCI, CATP=C,LINE=LNEQ, 
REMOTE=T, PORT=5 

LPORT EU1=TRMB, EU2=TLO2,USERTP=TCI, CATP=C, LINE=LNEO, 
REMOTE=T, PORT=6, 

LPORT EU1=TRMC, EU2=TL@2,USERTP=TCI, CATP=C,LINE=LNEO, 
REMOTE=T, PORT=7 

LOCAP TYPE=(STDMCP), LOW=GVD1, MEDIUM=GVD1, HIGH=GVD1, REMOTE=(T) 

LOCAP TYPE=(TCI),LOW=GVD1,MEDIUM=GVD1,HIGH=GVD1,REMOTE=(T) 

PRCS LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

DISCFILE FILEDIV=15, 

ENDCCA 

MCP MCPNAME=C8& 
CACH=(@8, 2400, SWITCHED, SYNC) 
CACH=(@9, 2400, SWITCHED, SYNC) 
CACH=(15,9600,X21) 


@ ©@8 © 





a. Local node (S) 


Figure 3-29. Sample ICAM Network Definition for a NORDIC Circuit-Switched PDN (Part 1 of 3) 
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COMMCT 
TTT2 CCA TYPE=(GBL,,T), GAWAKE=YES,OCA=YES, x 
FEATURES=(OPCOM, SEGMENTS ,OUTOELV) 
BUFFERS 100,64,5,ARP=35,LINKPAK=(5@,8@, 10) ,UDUCT=(24, 28,3) 




































@ 
8 SLO2 LOCAP TYPE=(STDMCP),LOW=GVD2,MEDIUM=GVD2,HIGH=GVD2 
TLO2 LOCAP TYPE=(TCI), LOW=GVO2,MEDIUM=GVD2,HIGH=GVD2 
(5) | csw2 PDN TYPE=CIRCUIT, CARRIER=NORDIC 
(6) |LoT2 LOTE CPSTBL=TAB2 
(7) | TAB2 CPSTB CPS=03, TBD=60 
CPSTB CPS=21,NOR=0,TBR=0 
CPSTB CPS=(20,44) ,NOR=5, TBR=5 
CPSTB CPS=61,NOR=(2, 10), TBR=(10,60) 
CPSTB CPS=71,NOR=(, 10), TBR=(, 1800), END=TAB2 
LNE2 VLINE DEVICE=ABM, TYPE=(9600,X21,SWCH), ID=15 x 
CMDADDR=3,RSPADOR=1 
(9) |roT2 ROTE ADDRESS=1234567, TIMER=10 
LPORT EU1=SL@2, EU2=SLO1,USERTP=STDMCP, CATP=C, LINE=LNE2, x 
REMOTE=S ,PORT=1 
LPORT EU1=SL@2,EU2=TRM1,USERTP=STOMCP, CATP=C,LINE=LNEZ, x 
REMOTE=S ,PORT=2 
LPORT EU1=SL@2, EU2=TRM2, USERTP=STOMCP, CATP=C,LINE=LNEZ, x 
REMOTE=S , PORT=3 
H LPORT EU1=SL02, EU2=TRM3, USERTP=STDMCP, CATP=C,LINE=LNEZ, x 
i REMOTE=S ,PORT=4 
LPORT EU1=TLO2,EU2=TLO1,USERTP=TCI,CATP=C,LINE=LNEZ, x 
REMOTE=S, PORT=5 
LPORT EU1=TLO2, EUZ=TRMB,USERTP=TCI,CATP=C,LINE=LNE2, x 
REMOTE=S , PORT=6 
LPORT EU1=TL@2, EU2=TRMC,USERTP=TCI, CATP=C,LINE=LNE2, x 
REMOTE=S , PORT=7 
QD | si01 LOCAP TYPE=(STDMCP),LOW=GV02,MEDIUM=GVD2,HIGH=GVD2,REMOTE=(S) 
TLO1 LOCAP TYPE=(TCI), LOW=GVD2,MEDIUM=GVD2, HIGH=GVD2,REMOTE=(S) 
TRM1 TERM ADDR=(28,51), FEATURES=(U400, 1920) ,REMOTE=(S), x 
LOW=GVD2,MEDIUM=GVD2, HIGH=GVD2, INPUT=(SL@2) 
TRM2 TERM ADDR=(28,52) , FEATURES=(U400, 1920) , REMOTE=(S), x 
LOW=GV02, MED IUM=GVD2, HIGH=GVD2, INPUT=(SL@2) 
TRM3 TERM ADDR=(28,53), FEATURES=(U400, 1920), REMOTE=(S), x 
LOW=GVD2,MEDIUM=GVD2, HIGH=GVD2, INPUT=(SL@2) 
TRMB TERM ADDR=(28,52), FEATURES=(U400, 1920) ,REMOTE=(S), x 
LOW=GVD2,MEDIUM=GVD2,HIGH=GVD2 
TRMC TERM ADDR=(28,53), FEATURES=(U400, 1920) ,REMOTE=(S), x 
LOW=GVD2, MEDIUM=GVD2, HIGH=GVD2 
Gvo2 DISCFILE FILEDIV=15 
TvD2 DISCFILE MSGSIZE=960 
ENDCCA 





cP MCPNAME=C8 
CACH=(08, 2400, SWITCHED ,SYNC) 
CACH=(15,9600,X21) 





@ © @ 






b. Remote node (T) 


NOTES: 


® 


@ 


Start of a global network. The network that defines the local node (S) is named TTT1. The network that defines 
the remote node (T) is named TTT2. GAWAKE and DCA are required for circuit-switched PONs. Features selected 
are operator communication, segmented message processing, and ICAM output delivery notice. 


100 64-word network buffers are used with a threshold of 5 network buffers. 35 activity request packets are 
specified as well as 50 link buffers, 80-words long, with a threshold of 10. User data unit control tables are 
specified as 24 with a threshold of 3. 





Figure 3-29. Sample ICAM Network Definition for a NORDIC Circuit-Switched PDN (Part 2 of 3) 


UP-9745 Rev. 3 











Defining Your Network 









































3) Two locap files are specified in each network to support user programs. One locap file in each network supports 
the ICAM standard interface, and one supports the transaction control interface (TCi) for IMS operation. Three 
priority input queues on disk (GVD1) are defined for each file. 


Only the TTT1 network has terminals connected to it. Some of these terminals are connected in sessions with the 
remote node as shown in Table 3-7, and some are for local usage only. 


Lines LNE1 and LNES define their attached terminals as UNISCOPE type with a line buffer length of 256 bytes. Line 
speed is 2400 baud. The lines are synchronized and are switched (dialup). 


The three terminals for each line (LNE1 and LNES5) are all UTS 400, set to display 1920 characters. The ADDR 
operand specifies the rid and sid for each terminal. Three priority output files on disk (GVD1) are specified for each 
terminal. The SLO2 locap file is designated to retrieve input messages for the terminais on line LNE1, and the TLO2 
locap file is designated to retrieve input messages for the terminalis on line LNES. 


TRML and TRMW are connected to lines LNE3 and LNE4, respectively, and are UTS 20 local workstations in the 
TTT1 network. 


© 


The PDN macroinstructions begin the public data network portion of these network definitions. The networks are 
defined as circuit-switched and the carrier as NORDIC. 


©) 


The LDTE macroinstructions define the attributes of the data terminal equipment (DTE) local to the network, LOT 1 
for TTT1 and LOT2 for TTT2. The local calling numbers (ADDRESS=) are not stated because it is not required. By 
default, neither incoming nor outgoing line identifications are validated, nor are outgoing calls barred. Since 
CPSTBL= is specified for each network, the specifications for the call progress signals are defined in the CPSTB 
macroinstructions. If CPSTB is not specified, the default values in Table 2~3 are called. 


The CPSTB macroinstructions redefine the specifications for the call progress signals identified in the CPS 
operands. Refer to the example at the end of 2.4 for a description of the use of the CPSTB macroinstruction. 


@ © 


The VLINE macroinstruction describes the physical link between the System 80 node and the public data network. 
ABM must be specified for circuit-switched PDNs. The TYPE= operand specifies that the line speed is 9600 baud, 
the interface is a CCITT X.21, and the line is switched (dialup). The sica line number is 15. 


The RDTE macroinstruction in each network definition defines the attributes of the data terminal equipment that is 
remote’ to it. ADDRESS= gives the telephone number of the remote node; TIMER= specifies that the line is shut 
down after a five-second period of no activity. 


© 


The LPORT macroinstruction defines the parameters for a session between an end user at the local node and an 
end user at the remote node. Alt of the end users specified in the LPORT macroinstructions and the sessions 
defined are listed in Table 3-7. The ICAM interfaces (USERTP=) are identified as standard for the first four ports 
and transaction control (IMS) for the rest. Dynamic sessions with error recovery are specified (CATP=C). The 
VLINE is identified (LNEO), the remote node {T), is identified, the logical ports are given the identifications 1, 2, 3, 
etc. 


© 


The remote locap file SLO2 in the local node and the remote locap file SLO1 in the remote node support the ICAM 
standard interface (STDMCP). Three priority queues are specified on disk for each LOCAP from which messages 
can be retrieved. The LOCAP macroinstructions TLO2 and TLO1 complete the interface for IMS users. 


The PRCS macroinstruction for node S defines a process file PRF1 for temporary storage of messages. Three 
priority files are established. No process files are specified for the remote node T. 


The DISCFILE macroinstructions GVD1 and GVD2 provide the storage space on disk required for the STDMCP 
users. The percentage of space allocated for the control area is 15. TVD1 and TVD2 provide storage space on 
disk for IMS (TCI) users. 


The network definition is ended. 


@® © © © 


The CACH statements assigned to LNE1 (08) and LNES (09) indicate half duplex lines. The CACH statements 
assigned to an odd numbered port (15) indicate a full duplex line for VLINE LNEO. 





Figure 3-29. Sample ICAM Network Definition for a NORDIC Circuit-Switched PDN (Part 3 of 3) 
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Table 3-7. End User Sessions for the Sample NORDIC Circuit-Switched PDN 


Local End Users (TTT1) 
es 

























































LOCAP User program (STDMCP) 
LOCAP User program (TCI) 
#(LINE 
TERM UTS 400 terminal 
TERM UTS 400 terminal 
TERM UTS 400 terminal 
#(LINE 
“TERM UTS 20 local workstation 
#(LINE 
*TERM UTS 20 local workstation 
#(LINE 
*TERM UTS 400 terminal 
TERM UTS 400 termina! 






UTS 400 terminal 
Process file 


ee 
LOCAP TLO2 User program {TCl) 
EE caM 


#TERM 








interface 










STOMCP 
STDMCP 
STDMCP 
TCI (IMS) 
TC! (IMS) 
TCi (IMS) 
TCI (IMS) 










LEGEND: 
# The LINE macroinstruction is included only to show line/terminal relationships. 
. This local end user is not used in sessions with remote end users. 


The third type of circuit-switched public data network ICAM supports is NORDIC 
(computer to UTS 20X). Figure 3-30 shows a typical environment. 
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Figure 3-30, 





Typical NORDIC Circuit-Switched PDN Environment (Computer to UTS 20X Terminal) 
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When you code your ICAM network definition for NORDIC (computer to UTS 20X 
terminal), you need to describe the public data network and both the local data 
terminating equipment (LDTE) and remote data terminating equipment (RDTE). 
ICAM provides the following special macros to do this: 


These Macros: Describe: 

PDN The kind of public data network 

LDTE The attributes of the local data terminating equipment 
CPSTB A table of actions for call progress signals 

LINE The attributes of the link to the PDN 

RDTE The attriubtes of the remote data terminating equipment 
PGROUP Specifies the poll group for the UTS 20X terminals 
TERM Describes the terminal attached to the PDN 


Table 3-8 provides an order of presentation of macros you should use when you code 
your circuit-switched public data network (computer to UTS 20X terminal). 





Figure 3-31 illustrates a typical computer to UTS 20X NORDIC circuit-switched 
public data network. 


Table 3-8. Order of Presentation for Macros in a Network Definition for a Circuit-Switched PDN 
(Computer to UTS 20X Terminal} 


| Won-Pow Circuit-Switched Environment 


CCA PON 
BUFFERS LDTE 
LOCAP cPsTs 
LINE LINE 
TERM RDTE 
LINE PGROUP * 
TERM TERM 
DISCFILE ROTE 
PRCS PGROUP * 
DLIST TERM 
MPSTART ENDCCA 


















































‘ PGROUP defines a polling group for remote workstations 
and UTS 20X terminals. All of the other macroinstructions 
are the same as defined in Table 3-6. 
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TYPE=(GBL, ,A), GAWAKEYES, DCAYES, 
FEATURES=(OPCOM, OUTDELV, SEGMENTS) 

50,256, 10, ARP=40, STAT=YES, LINKPAK=(45 80), 
UDUCT=(7,28,3) 
TYPE=(DMI), IAS=(YES, OFF) , MODE=SYSTEM 
-TYPE=(STDMCP) , LOW=MAIN 
TYPE=(STDMCP) , LOW=MAIN 

TYPE=CIRCUIT, CARRIER=NORDIC 

LGROUP=( 1,0) 
DEVICE=(UTSX) , TYPE=(9600, X21, SWCH) 
ADDRESS=123456 

PGID=28 
FEATURES=(U20,,, ,PRIMARY) ,ADDR=(28,51), 
AUX 1=(COP, 22), INPUT=YES 
FEATURES=(U2@, ,, , SECONDARY) , ADDR=(28,52), 
AUX1=(COP, 22), INPUT=YES 


MCPNAME=C3 
CACH=( 13,9680, SWITCHED, SYNC,X21) ,LTDE=LOT1 


Sample ICAM Network Definition for a Circuit-Switched PDN (Computer to 
UTS 20X Terminal) 
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3.6.2. Packet-Switched Public Data Networks 
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Packet-switched public data networks consist of switching nodes and high-speed 
digital communications trunks as illustrated in Figure 3-32. Under OS/3, ICAM 
provides the interface between your program in your computer (your computer is 
considered a data terminal equipment (DTE)) and the public data network’s data 
circuit-terminating equipment (DCE). For packet-switched networks, a DTE can be 
an OS/3 system or a Universal Terminal System 4020/4040 with workstations. 


In a packet-switched environment, all user data is formed into variable-length entities 
called packets. (The 32-byte packet size is not supported.) Appended to each data 
packet is a header that provides control functions and addressing information to 
enable the packet to be delivered to the correct destination. All data packets are 
transferred over virtual circuits. A virtual circuit is a bidirectional association 
between two data terminal equipments, where data transfer takes the form of 
packets. Transmission facilities in a public data network are assigned only when they 
are needed, thus enabling sharing of public data network resources. 


You'll notice in Figure 3-32 a series of dashed lines in the public data network. These 
represent digital communications trunks that connect the various data circuit 
terminating equipment nodes. Each trunk has the capability to support both 
permanent and switched virtual circuits. 


Two kinds of virtual circuits are used in packet-switched public data networks: 
1. Permanent virtual circuits (PVC) 
2. Switched virtual circuits (SVC) 


A permanent virtual circuit is a permanent association between two data terminal 
equipments. This is analogous to a point-to-point private line, and requires no call 
setup or clearing by ICAM. 


A switched virtual circuit is a temporary association between two data terminal 
equipments. When your program requests a session with another end user, ICAM 
initiates the association by a call request to the public data network. When the 
association is complete, the public data network reports this to ICAM, which in turn 
returns an open accept datagram to your program. Your program can now send 
messages to the remote end user. If the public data network cannot complete the 
association (the receiving end user cannot or does not want to receive the message, or 
there is a problem on the public data network), the public data network reports this to 
ICAM, and ICAM reports to your program in an open reject datagram. 
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Defining Your Network 


When you code your ICAM network definition you'll find that most of the network 
definition is the same as any other global network definition using distributed 
communications architecture (DCA), except you need to describe the public data 
network and the facilities that are present in the remote subscriber environment. 
ICAM provides a few special macros to do this, and they follow the typical 
organization of a public data network to make it easier to do. For example: 


These Macros: Describe: 
PDN The kind of public data network 
TRUNK How many permanent and switched virtual circuits are 


used, and how you use them. 


VLINE Some facts about the physical communications line to the 
public data network: where it is attached to your 
computer and what line protocol is used. 


SUB Details about the remote subscriber 
PVC Details about permanent virtual circuits 
Remote resources Remote locap files, process files, and terminals in the 


remote subscriber computer node. 





SESSION For DDX only, details about static sessions used over 
permanent virtual circuits. 


Table 3-9 provides a suggested order of presentation you can use when you code your 
packet-switched public data network. 
Table 3-9. Order of Presentation for ICAM Macros in a Definition for a Packet-Switched PDN 


Macro Remarks 
Description of Local {Non-PDN) Communications 


CCA Begins the network definition 
BUFFERS Specifies system resources 
LOCAP) 4 Create LOCAP files for users 
LINE ) Describes the first local communications line 
TERM), Describe the terminals on the first line 
LINE, Describes the last local communications line 
TERM, , Describe the terminals on this last local line _ 
continued 
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Table 3-9. Order of Presentation for ICAM Macros in a Definition for a Packet-Switched PDN 


(cont.) 


Macro 


Remarks 


Description of Local (Non-PDN} Communications (cont.) 


DISCFILE ., 
JOURNFILE ., 
PRCS) 
SESSION) , 


MPSTART 


Declare any disk files used for disk queuing 
Declare journal files needed 

Declare any local process files needed 
Declare any required local static sessions 


Describe any local message processing routines 


Description of Packet-Switched Environment 


PDN 


TRUNK, 


@ VLINE 


VCGROUP 


SUB, 


PVC) 4 


LOCAP) ., 
TERM) 
PRS) 


SESSION, , 


SUB 


PVC an 


LOCAP 


@ . 
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Begins the definition of a packet-switched PDN. Defines the carrier, its 
type, and packet size. 


Declares the attributes of the first logical link between this data terminal 
equipment (DTE) and the PDN's data circuit terminating equipment (DCE). 


Describes the physical link that connects this DTE and the PDN's DCE. 


Define any permanent or switched virtual circuit groups on this trunk. 
(Used only with DDX and PSS PDNs.) 


Defines the attributes of the first remote subscriber on this trunk. 


\dentify any permanent virtual circuits on this trunk used with the 
subscriber just defined. 


Identify any remote subscriber programs (LOCAP files). 
Identify any remote subscriber terminals 
Identify any remote subscriber process files. 


Define static sessions between end users over a permanent virtual circuit. 
Only one static session per PVC. 


Defines the attributes of the last remote subscriber on this trunk. 


\dentify any permanent virtual circuits on this trunk used with the 
subscriber just defined. 


Identify any remote subscriber programs (LOCAP files). 


continued 
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Table 3-9. Order of Presentation for ICAM Macros in a Definition for a Packet-Switched PDN 


(cont.) 


Macro Remarks 


Description of Packet-Switched Environment 


TERM, y 
PRCS,. 


SESSION, , 


TRUNK, 
VLINE,, 


VCGROUP 


SUB 


PVC, 


LOCAP) 
TERM), 
PRCS)_,, 


SESSION, 


SUB 


PVC an 


LOCAP,,, 
TERM, 
PRCSa.n 


SESSION, , 


ENDCCA 
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Identify any remote subscriber terminals 
Identify any remote subscriber process files. 


Define static sessions between end users over a permanent virtual circuit. 
Only one static session per PVC. 


Declares the attributes of the last logical link between this DTE and the 
PDN’s DCE. 
Describes the physical link that connects this DTE and the PDN’s DCE. 


Define any permanent or switched virtual circuit groups on this trunk. 
(Used only with DDX and PSS PDNs.) 


Defines the attributes of the first remote subscriber on this trunk. 


Identify any permanent virtual circuits on this trunk used with the 
subscriber just defined. 


Identify any remote subscriber programs (LOCAP files). 
Identify any remote subscriber terminals 
Identify any remote subscriber process files. 


Define static sessions between end users over a permanent virtual circuit. 
Only one static session per PVC. 


Defines the attributes of the last remote subscriber on this trunk. 


Identify any permanent virtual circuits on this trunk used with the 
subscriber just defined. 


Identify any remote subscriber programs (LOCAP files). 
Identify any remote subscriber terminals 
Identify any remote subscriber process files. 


Define static sessions between end users over a permanent virtual circuit. 
Only one static session per PVC. 


Identifies the end of this network definition. 
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A 3-Node DDX Packet-Switched Public Data Network 


Figure 3-33 illustrates a 3-node DDX packet-switched public data network 
environment, and Figure 3-34 shows three ICAM network definitions required to 
support it. 


Before we get into discussing how we put together this PDN network, lets talk about 
what local means and what remote means. Each ICAM network definition describes 
the ICAM environment where it exists; i.e., in this computer. It also describes the 
environment in the other computer where the other end user exists. This is the 
environment of the remote subscriber. Obviously, when we define a network 
definition for subscriber A, subscribers B, and C are remote subscribers, and when we 
define a network for subscriber C, subscribers A and B are remote, etc. 


Figure 3-34 contains three ICAM network definitions; one for each subscriber 
(computer node) where ICAM is present. Each ICAM network definition defines the 
resources required in its own node, the type of public data network link used to 
connect the subscribers, then each subscriber remote to it. 


The first part of each network definition describes the resources needed by ICAM to 
support local communications. This includes any locally connected terminals, locap 
files to support your programs, and process files you may need. It must also include 
any resources ICAM needs to support the public data network you are using, such as 

@ DCA routines, data unit control tables, and link buffers. Up to this point a network 
designed to support a public data network is much the same as one you might specify 
to support any global network. 


You begin defining the public data environment by specifying a PDN macro. This 
macro tells ICAM the kind of public data network you are using, maximum 
sequencing number, and packet size. Then you describe the communications link that 
connects this node to the public data network. 


Processor A, known as subscriber SUBA, contains two communications links to the 
DDX public data network called trunks. A trunk is a logical concept used to define a 
communications link (a logical path) between a local subscriber’s data terminal 
equipment (DTE) and a public data network’s data circuit terminating equipment 
(DCE). You use a TRUNK macro to describe the characteristics of each trunk. 
Included are its calling address (similar to a telephone number for this trunk), how 
many permanent virtual circuits it supports, how many input only, output only, and 
input/output switched virtual circuits it supports and its timeout value. 


Notice that trunk TK1 connects subscriber SUBA in processor A to subscriber SUBB 
in processor B, and that all of the attributes that ICAM needs to know to carry on 
communications with remote subscriber SUBB are defined following the TRUNK 
macro labelled TK1. Subscriber SUBA in processor A also connects to remote 
subscriber SUBC using trunk TK2, and the characteristics ICAM needs to 
communicate with remote subscriber SUBC follow the trunk TK2 definition. Two 
separate trunks were used to improve throughput by adding more than one link. 
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VLINE macro VLN1 describes the physical characteristics of trunk TK1, and VLINE 
macro VLN2 covers the physical characteristics of trunk TK2. They cover such 
important items as communications adapter location, line speed, and link access 
procedure used. 


You describe each remote subscriber with a SUB macro. The SUB macro tells ICAM 
the remote subscriber’s calling address (similar to a telephone number for the remote 
trunk), the procedure category to indicate the type of subscriber, whether reverse 
charges (similar to collect calls) will be accepted from the remote subscriber, if 
sessions are multiplexed (more than one session per virtual circuit), the closed user 
group code (if used), and input and output window sizes. 


At this point, you describe any permanent virtual circuits that connect this subscriber 
to the public data network. You define permanent virtual circuits with PVC macros. 
Permanent virtual circuits are point-to-point, non-switched circuits over which only 
data, reset, interrupt, and flow control packets can flow. Two permanent virtual 
circuits connect subscriber SUBA to subscriber SUBB on trunk TK1 and one is used to 
connect subscriber SUBA to subscriber SUBC on trunk TK2. 


In a DDX public data network, 4080 logical channels can be specified. Logical 
channels are allocated in 16 logical channel groups (0 to 15), and each logical group 
can have up to 255 logical channels. (You cannot specify logical channel zero (LCN 0).) 
On trunk TK1 we selected logical channel group 0 and logical channel numbers 1 and 
2 for our permanent virtual circuits. On trunk TK2, we also selected logical channel 
group number 0, and we used logical channel number 1 for our only permanent virtual 
circuit. Note, that the logical channel group number/logical channel number concept is 
only used with DDX public data networks. 


Two programs reside with subscriber SUBB: program B1 and program B2. You define 
these remote programs (remote to subscriber SUBA) with LOCAP macros. Notice that 
the names of the locap files thus defined are specified in the labels of the LOCAP 
macros and they are marked as being remote to subscriber SUBA by the REMOTE= 
keyword. 


Three programs reside with subscriber SUBC: programs Cl, C2, and C3 as identified 
by the labels of their LOCAP macros. Communication with these programs is by 
means of trunk TK2. 


Two SESSION macros define two static sessions on trunk TK1 between programs Al 
and A2 and programs B1 and B2, respectively. These sessions use permanent virtual 
circuits PCA1 and PCA2. Notice, that although a permanent virtual circuit is defined 
on trunk TK2 to connect subscriber SUBA and subscriber SUBC, no corresponding 
SESSION macro is specified. This means that the programs in these nodes 
communicate using dynamic sessions over the permanent virtual circuit. 


Parts B and C of Figure 3-34 provide network definitions for subscribers SUBB and 
SUEC respectively; and they are quite similar to that shown in part A for subscriber 
SUBA. They are actually mirror images of the definition for subscriber SUBA viewed 
from their own computer node. 
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Each network definition is ended with an ENDCCA macro. 


To summarize the process of ICAM network definition for a DDX public data network, 
you must define an ICAM network for each computer node (subscriber) as follows: 


Specify: 

¢ DCA=YES in each CCA macro 

* all local resources ICAM needs in each computer node 

¢ the public data network you are using in a PDN macro 

¢ TRUNK and VLINE macros for each trunk 

* the VCGROUP macro to identify virtual circuit grouping 

¢ — the characteristics of the remote subscriber in a SUB macro 
¢ a PVC macro for each permanent virtual circuit 

¢ aLOCAP macro for each remote subscriber program 


¢ aSESSION macro for each static session 
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1 72 
1. | BOXA CCA _—- TYPE=(GBL, ,NOD1), FEATURES=(OPCOM, DATIME), x 
GAWAKE=YES, DCA- YES 
2. BUFFERS 100,64,0,ARP=35, STAT=YES,UDUCT=( 18, 28,2), X 
LINKPAK=( 100,76, 15) 

3.4A1 LOCAP TYPE=(STDMCP), LOW=MAIN, PROTYP=XPARENT 
A2 LOCAP TYPE=(STDMCP) , LOW=MAIN, PROTYP=XPARENT 
A3 LOCAP TYPE=(STDMCP) , LOW=MAIN 
AG LOCAP TYPE=(STDMCP) , LOW=MAIN 
AS LOCAP TYPE=(STDMCP) , LOW=MAIN 

4.|PDNA PDN —_- CARRIER=DDX, L3MOD=128, MXCALL=3 

5./TK1 TRUNK CALLNO=5424986, DATATIM=1@ 

6./VLN1 VLINE DEVICE=LAPB, TYPE=(2408), ID=1,CHAN=9 

7.|VGA1 VCGROUP LCGN=@, TYPE=PVC, NUMBER=2 

8.|SUBB SUB —_— CALLNO=5425303, CATP=H 

9.|PCA1 PVC —LCGN=@, LCN=1, IWS=7,, OWS=7 
PCA2 PVC —LCGN=0, LCN=2, IWS=7, OWS=7 

10.184 LOCAP TYPE=(STDMCP) , LOW=MAIN, PROTYP=XPARENT , REMOTE=(SUBB, PDN) 
B2 LOCAP TYPE=(STDMCP) , LOW=MAIN, PROTYP=XPARENT , REMOTE=(SUBB, PDN) 

11./S4 SESSION EU1=A1,EU2=B1,PVC=PCA1 
$2 SESSION EU1=A2,EU2=B2, PVC=PCA2 

12. |TK2 TRUNK CALLNO=5425777, DATATIM=10 

13. {VLN2 VLINE DEVICE=LAPB, TYPE=(2400) , ID=2, CHAN=8 

14. |VGA2 VCGROUP LCGN=0, TYPE=PVC,NUMBER=1 
VGA3 VCGROUP LCGN=1, TYPE=IOSVC, NUMBER=2 

15. |SUBC SUB —_—CALLNO=5425662, CATP=F,, IWS=7, OWS=7 

16. |PCA3 PVC —LCGN=@, LCN=1, IWS=7, OWS=7 

17.\C1 LOCAP TYPE=(STDMCP), LOW=MAIN, REMOTE=(SUBC, PDN) 
c2 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=(SUBC, PDN) 
c3 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=(SUBC , PDN) 

18. ENDCCA 


a. Subscriber A's network definition 


1. Start of a global network definition. Operator communications and date and time stamping are required. 
GAWAKE and DCA must be specified. 


2. 100 64-word network buffers are used with no threshold. 35 activity request packets. Buffer pool usage 
statistics required. 18 user data unit control tables required, each 28 words long with a threshold of 2. 100 
link buffers, 76 words long, with a threshold of 15. 


3. Five LOCAP files required to support five user programs in this processor. All use the ICAM standard 
interface. One low priority input queue used on each LOCAP file. 


4. Begins PDN portion of definition. Carrier is DDX, maximum sequencing number is 128, and iCAM will try to 
establish a call over a switched virtual circuit a maximum of 3 times. 


Figure 3-34. _ICAM Network Definition Coding to Support a 3-Node Packet-Switched DDX PDN 
(Part 1 of 5) 
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11. 


14. 


15. 


16. 


17. 


18. 


Defines trunk TK1, its local DTE calling address, and the number of seconds before a data packet timeout. 
This virtual line uses X.25 LAPB protocol. Line speed is 2400 baud and the SLCA ID is 1. 


Because this is a DDX PDN, virtual circuit groups are required. On this trunk, logical channel group number 0, 
two permanent virtual circuits are used: PCAl and PCA2. 


This trunk connects to subscriber SUBB, whose DTE calling address is 5425303, and the procedure category 
is H (i.e., a foreign node, DDX only). 


Two permanent virtual circuits are defined on logical channel group 0. Their input and output window sizes 
are 7. 


Two remote LOCAP files are described. They reside in subscriber SUBB's processor. They each have a low 
priority queue for input, and communications is by PDN. 


Two static sessions are identified between end users (programs) Al and B1, and between end users A2 and 
B2. Note that these are the names of the LOCAP files previously established in items 3 and 10. Static 
sessions can only be defined for category H with DDX. 

Defines trunk TK2, its local DTE calling address, and the number of seconds before a data packet timeout. 
This virtual line uses X.25 LAPB protocol. Line speed is 2400 baud and the SLCA ID is 2. 

Because this is a DDX PDN, virtual circuit groups are required. Logical channel group number 0 has one 
permanent virtual circuit, its logical channel number is 1. Logical channel group 1 has two switched virtual 


circuits with input and output capabilities. 


This trunk connects to subscriber SUBC, whose DTE calling address is 5425662, and the procedure category 
is F. Input and output window sizes are both 7. 


A permanent virtual circuits is defined on logical channel group 0. Its input and output window sizes are 7. 


Three remote LOCAP files are described. They reside in subscriber SUBC’s processor. They each have a low 
priority queue for input, and communications is by PDN. 


The network definition is ended. 


Figure 3-34. ICAM Network Definition Coding to Support a 3-Node Packet-Switched DDX PDN 
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1 72 
1.|BOXB CCA _—«TYPE=(GBL, ,NOD1),, FEATURES=(OPCOM, DATIME), x 
GAWAKE=YES, DCA=YES 
2. BUFFERS 100,64,@,ARP=35, STAT=YES, UDUCT=( 18, 28,2), x 
LINKPAK=( 100,76, 15) 
3.|81 LOCAP TYPE=(STDMCP) , LOW=MAIN, PROTYP=XPARENT 
B2 LOCAP TYPE=(STDMCP) , LOW=MAIN, PROTYP=XPARENT 
4. |PDNB PDN —_—CARRIER=DDX, L3MOD=128, MXCALL=3 
5.|1k1 TRUNK CALLNO=5425303, DATATIM=10 
6.|VLN4 VLINE DEVICE=LAPB, TYPE=(2400), 1D=1, CHAN=9 
7.{vcG1 VCGROUP LCGN=0, TYPE=PVC, NUMBER=2 
8. | SUBA SUB — CALLNO=5424986, CATP=H 
9.|PCB1 PVC —_—LCGN=@, LCN=1, IWS=7, OWS=7 
PCB2 PVC — LCGN=0, LCN=2, IWS=7, OWS=7 
10.{A1 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=(SUBA, PDN) 
A2 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=(SUBA, PDN) 
11.|81 SESSION EU1=B1,EU2=A1,PVC=PCB1 
$2 SESSION EU1=B2,EU2=A2,PVC=PCB2 
12. ENDCCA 


b. Subscriber B’s network definition 


1. — Start of a global network definition. Operator communications and date and time stamping are required. 
GAWAKE and DCA must be specified. 


2. 100 64-word network buffers are used with no threshold. 35 activity request packets. Buffer pool usage 
statistics required. 18 user data unit control tables required, each 28 words long with a threshold of 2. 100 
link buffers, 76 words long, with a threshold of 15. 

3. TwoLOCAP files required to support two user programs in this processor. They use the ICAM standard 
interface. One low priority input queue used on each LOCAP file. PROTYP required to support distributed data 


processing. 


4. Begins PDN portion of definition. Carrier is DDX, level 3 modulus number is 128, and ICAM will try to establish 
a call over a switched virtual circuit a maximum of 3 times. 


5. Defines trunk TK1, its local DTE calling address, and the number of seconds before a data packet timeout. 
6. This virtual fine uses X.25 LAPB protocol. Line speed is 2400 baud and the SLCA ID is 1. 


7. Because this is a DDX PDN, virtual circuit groups are required. On this trunk, logical channel group number 0, 
two permanent virtual circuits are used: PCB] and PCB2. 


8. This trunk connects to subscriber SUBA, whose DTE calling address is 5424986 (trunk TK1 on SUBA), and the 
procedure category is H. 


Figure 3-34. ICAM Network Definition Coding to Support a 3-Node Packet-Switched DDX PDN 
(Part 3 of 5) 
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10. 


11. 


12. 


NO we 


oo 


10. 


11. 


Two permanent virtual circuits are defined on logical channel group 0. Their input and output window sizes 
are 7. 


Two remote LOCAP files are described. They reside in subscriber SUBA's processor. They each have a low 
priority queue for input, and communications is by PDN. 


Two static sessions are identified: between end users (programs) Al and B1, and between end users A2 and 
B2. Note that these are the names of the LOCAP files previously established in items 3 and 10. 


The network definition is ended. 





« |BOXC CCA TYPE=(GBL, ,NOD3) , FEATURES=(OPCOM, DATIME), xX 


GAWAKE=YES , OCA=YES 
BUFFERS 100,64,8,ARP=35, STAT=YES ,UDUCT=( 18, 28,2), x 
LINKPAK=( 100,76, 15) 


.{B1 LOCAP YTYPE=(STDMCP),LOW=MAIN 
B2 LOCAP TYPE=(STDMCP) ,LOW=MAIN 
PDNC PDN CARRIER=DDX, L3MOD=128 ,MXCALL=3 
TK1 TRUNK CALLNO=5425662, DATATIM=10 
VLN1 VLINE DEVICE=LAPB, TYPE=(2480), 1D=1,CHAN=9 
vcG1 VCGROUP LCGN=0, TYPE=PVC ,NUMBER=1 
vcG2 VCGROUP LCGN=@1,TYPE=IOSVC ,NUMBER=2 
SUBA SUB CALLNO=5425777, CATP=F 
-|PCc1 Pvc LCGN=@, LCN=1, IWS=7, OWS=7 
A3 LOCAP TYPE=(STDMCP),LOW=MAIN, REMOTE=(SUBA, PDN) 
Ad LOCAP TYPE=(STDMCP), LOW=MAIN, REMOTE=(SUBA, PDN) 
A5 LOCAP TYPE=(STDMCP),LOW=MAIN,REMOTE=(SUBA, PDN) 
ENDCCA 


c. Subscriber C’s network definition 


Start of a global network definition. Operator communications and date and time stamping are required. 
GAWAKE and DCA must be specified. 


100 64-word network buffers are used with no threshold. 35 activity request packets. Buffer pool usage 
statistics required. 18 user data unit control tables required, each 28 words long with a threshold of 2. 100 
link buffers, 76 words long, with a threshold of 15. 


Two LOCAP files required to support two user programs in this processor. They use the ICAM standard 
interface. One low priority input queue used on each LOCAP file. PROTYP required to support distributed data 
processing. 


Begins PDN portion of definition. Carrier is DDX, level 3 modulus number is 128, and ICAM will try to establish 
a call over a switched virtual circuit a maximum of 3 times. 


Figure 3-34. ICAM Network Definition Coding to Support a 3-Node Packet-Switched DDX PDN 
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5. Defines trunk TK1, its local DTE calling address, and the number of seconds before a timeout. 

6. This virtual line uses X.25 LAPB protocol. Line speed is 2400 baud and the SLCA ID is 1. 

7. Because this is a DDX PDN, virtual circuit groups are required. On this trunk, logical channel group 
number 0, one permanent virtual circuits is used: PCC1. On logical channel group number 1, two 


input and output switched virtual circuits are used. 


8. This trunk connects to subscriber SUBA, whose DTE calling address is 5425777 (trunk TK1 on 
SUBA), and the procedure category is F. 


9. One permanent virtual circuit is defined on logical channel group 0. Input/output window size is 7. 


10. Three remote LOCAP files are described. They reside in subscriber SUBA’s processor. They each 
have a low priority queue for input, and communications is by PDN. 


11. The network definition is ended. 


Figure 3-34. ICAM Network Definition Coding to Support a 3-Node Packet-Switched DDX PDN 
(Part 5 of 5) 


Network Definition to Support a DATAPAC, TRANSPAC, DATEX, or IBERPAC 
Packet-Switched PDN 


Figure 3-35 illustrates a typical 2-node DATAPAC, TRANSPAC, DATEX, or 
IBERPAC packet-switched PDN, and Figure 3-36 illustrates the coding necessary to 
generate an ICAM network in each computer node to support it. The coding examples 
are for a DATAPAC system; however, except for the carrier name specified in the PDN 
macro, the ICAM network definitions apply to TRANSPAC and DATEX packet- 
switched public data networks as well. 


You will notice that DCA=YES and GAWAKE=YES are specified in the CCA macro 
because distributed communications architecture and the ICAM GAWAKEE facilities 
are required for all packet-switched PDNs. Six permanent virtual circuits and four 
switched virtual circuits are defined. 


Figure 3-37 shows a typical 3-node DATAPAC, TRANSPAC, or DATEX packet- 
switched PDN, with subscriber C as a packet-switched network. We included the 
entire COMMCT phase of system generation to illustrate the relationship of the 
system generation CACH statement and the ICAM network definition VLINE macro 
in regards to the port used for the virtual line. Notice that the ID you specify in the 
VLINE macro must agree with the SLCA you specify in the CACH statement. 


For IBERPAC: 
¢ Eliminate the WS operand in the TRUNK macro. 
e Add the IWS and OWS operands to the SUB and PUC macros. 


e Specify CALLING=YES in the SUB macro. 
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1, |PDNL CCA _—- TYPE=(GBL, , NODA) , PASSWORD=POC.. TEST , DCA=YES, 
FEATURES=(OPCOM, OUTDELV, SEGMENTS, RESTART), 
GAWAKE=YES 
2. BUFFERS 20, 100,2,ARP=3@, STAT=YES,UDUCT=( 16, 28,2) 
* 
* LOCAL DECLARATIONS 
* 
3.{CUP1 LOCAP TYPE=(STDMCP) ,LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 
cup2 LOCAP TYPE=(STDMCP), LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 
* 
* REMOTE DECLARATIONS 


PDN1 PDN 


4. 
5. | TRK1 TRUNK 
6./VLN1 VLINE 
7.|SUB1 SUB 
8.|PVC1 PVC 
PVC2 PVC 
PVC3 PVC 
PVC4 Pvc 
PVC5 PVC 
PVC6 PVC 
9.|RCU1 LOCAP 
RCU2 LOCAP 
10. ENDCCA 
MCP 
MCPVOL= 


CARRIER=DATAPAC, TYPE=PACKET , L3MOD=8 , PKTSIZ=256 
CALLNO=39999911,PVC=6, IOSVC=4, DATATIM=10,WS=4 
DEVICE=LAPB, TYPE=9600, ID=55 
CALLNO=39999912, MUX=YES, CATP=G, CUG=01 

LCN=1 

LCN=2 

LCN=3 

LCN=4 

LON=5 

LCN=6 
TYPE=(STDMCP) , LOW=MAIN , MEDIUM=MAIN, HIGH=MAIN, 
REMOTE=(SUB1,PDN) 
TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN, 
REMOTE=(SUB1,PDN) 


MCPNAME=C6 
REL13@ 


CACH=(55, 9600, FULL, ILA) 


11. END 


a. Subscriber 1 (}CAM network definition PDNL) 


1. Start of a global network definition. Specifies operator communications, segmented message processing, and 
warm restart capability. GAWAKE and DCA must be specified for all PDNs. 


2. 20 100-word network buffers are used with a threshold of 2 network buffers. 30 activity request packets are 
needed and buffer pool usage statistics are required. 16 user data unit control tables are required, each 28 
words long with a threshold of 2. 


3. Two LOCAP files (CUP1 and CUP2) are specified to support two user programs in this processor. All use the 
ICAM standard interface. Three priority queues are used on each LOCAP file. 


Figure 3-36. Sample 2-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 
Switched PDN (Part 1 of 4) 
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11. 


The PDN macro begins the public data network portion of this network definition. The carrier is the DATAPAC 
packet-switched network; level 3 modulus is 8; and packet size is 256. 


Defines trunk TRK1, its local subscriber data terminal equipment calling address, and the number of seconds 
before a data packet timeout (10 seconds). There are 6 permanent virtual circuits on this trunk and 4 
switched virtual circuits with /O capability. The level 3 window size is 4. 


All packet-switched PDNs use LAPB except DATAPAC, which can use LAPA. Line speed is 9600 baud and the 
ID is 55. 


This trunk connects to remote subscriber SUB1. Subscriber SUB1's DTE calling address is 39999912 and the 
procedure category is G. A closed user group code of 01 is specified. 


Six permanent virtual circuits are defined on six logical channels. Their input and output window sizes are 
defaulted to 7. 


Two remote LOCAP files (RCU1 and RCU2) are described. The programs they represent reside in the remote 
processor that supports the ICAM network named PDNR. Each remote LOCAP file has three priority queues 
for input. The suboperand SUB] points to the label of the SUB macro that contains the calling address of the 
remote subscriber on the PDN. 

Note that all communications are carried on by dynamic sessions; therefore, no SESSION macros are used. 


Ends the network definition. 


This CACH statement specifies an intelligent line adapter is connected on 55 to handle the PDN trunk. Note 
that this is the identifier specified in the VLINE macro. 


Figure 3-36. Sample 2-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 


Switched PDN (Part 2 of 4) 


UP-9745 Rev. 3 








10. 


11. 


ONaW 


. |PONR 


END 





CCA 


Defining Your Network 


i 





TYPE=(GBL, , NODA) , PASSWORD=POC. TEST , DCA=YES, 
FEATURES=(OPCOM, OUTDELV, SEGMENTS, RESTART), 
GAWAKE=YES 

BUFFERS 20, 100,2,ARP=30, STAT=YES ,UDUCT=( 16,28, 2) 


LOCAL DECLARATIONS 


LOCAP 
LOCAP 


REMOTE 


PDN 
TRUNK 
VLINE 
SUB 
PVC 
PVC 
PVC 
PVC 
PVC 
PVC 
LOCAP 


LOCAP 


ENDCCA 
MCP 


MCPVOL= 


TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 


DECLARATIONS 


CARRIER=DATAPAC, TYPE=PACKET , L3MOD=8, PKTSIZ=256 


CALLNO=399999 12, PVC=6, IOSVC=4, DATATIM=10,WS=4 
DEVICE=LAPB, TYPE=9680, ID=77, CHAN=10 
CALLNO=3999991 1, MUX=YES , CATP=G , CUG=01 

LCN=1 

LCN=2 

LCN=3 

LCN=4 

LCN=5 

LCN=6 
TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN, 
REMOTE=(SUB2,PDN) 
TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN, 
REMOTE=(SUB2,PDN) 


MCPNAME=C7 
REL 138 


CACH=(77 , 9600, FULL, ILA) , CHAN=10 


b. Subscriber 2 (ICAM network definition PDNR) 


Start of a global network definition. Specifies operator communications, segmented message processing, and 
warm restart capability. GAWAKE and DCA must be specified for all PDNs. 


20 100-word network buffers are used with a threshold of 2 network buffers. 30 activity request packets are 
needed and buffer pool usage statistics are required. 16 user data unit control tables are required, each 28 
words long with a threshold of 2. 


Two LOCAP files (RCU1 and RCU2) are specified to support two user programs in this processor. All use the 
ICAM standard interface. Three priority queues are used on each LOCAP file. 


Figure 3-36. Sample 2-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 
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4. | The PDN macro begins the public data network portion of this network definition. The carrier is the DATAPAC 
packet-switched network; level 3 modulus is 8; and packet size is 256. 


5. Defines trunk TRK2, its local subscriber data terminal equipment calling address, and the number of seconds 
before a data packet timeout (10 seconds). There are 6 permanent virtual circuits on this trunk and 4 
switched virtual circuits with [/O capability. The level 3 window size is 4. 


6. All packet-switched PDNs use LAPB except DATAPAC, which can use LAPA. Line speed is 9600 baud and the 
ID is 77 on channel 10. 


7. This trunk connects to remote subscriber SUB2. Subscriber SUB1’s DTE calling address is 39999911 and the 
procedure category is G. A closed user group code of 01 is specified. 


8. Six permanent virtual circuits are defined on six logical channels. Their input and output window sizes are 
defaulted to 7. 


9. Two remote LOCAP files (CUP1 and CUP2) are described. The programs they represent reside in the remote 
processor that supports the ICAM network named PDNL. Each remote LOCAP file has three priority queues for 
input. The suboperand SUB1 points to the label of the SUB macro that contains the calling address of the 
remote subscriber on the PDN. 


Note that all communications are carried on by dynamic sessions; therefore, no SESSION macros are used. 


10. Ends the network definition. 





11. This CACH statement specifies an intelligent line adapter is connected on 77 to handle the PDN trunk on 
channel 10. Note that this is the identifier specified in the VLINE macro. 


Figure 3-36. Sample 2-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 
Switched PDN (Part 4 of 4) 
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1.|DAT1 CCA TYPE=(GBL, ,NOD1) , FEATURES=(OPCOM) , GAWAKE=YES X 
DCA=YES 
2. BUFFERS 100,64,2,ARP=35, STAT=YES ,UDUCT=( 16, 28,2) 


LOCAL DECLARATIONS 


3./A1 LOCAP TYPE=(STDMCP) , LOW=MAIN 
A2 LOCAP TYPE=(STDMCP) , LOW=MAIN 
A3 LOCAP TYPE=(STDMCP) , LOW=MAIN 
4.|PDNA PDN —_ TYPE=PACKET, CARRIER=DATAPAC, L3MOD=8 , PKTSIZ=128 
5.) TRKA TRUNK CALLNO=5915484 ,WS=3,PVC=2, IOSVC=2 
6.|VLNA VLINE ID=62,DEVICE=LAPA 
* 
* REMOTE DECLARATIONS FOR SUBSCRIBER B 
* 
7. | SUBB SUB CALLNO=6887849, CATP=G 
8.|VCA1 Pvc _LCN=1 
9.)B1 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=( SUBB , PDN) 
B2 LOCAP TYPE=(STDMCP) , LOW=MAIN, REMOTE=(SUBB , PDN) 
* 
@ * REMOTE DECLARATIONS FOR SUBSCRIBER C 
* 
7.|SUBC SUB CALLNO=9918868, CATP=G 
8.|VCA2 PVC LCN=2 
9.|TRM1 TERM  FEATURES=(U2@) , ADDR=(30,31),REMOTE=(SUBC,PDN,PT), X 
LOW=MAIN ,MEDIUM=MAIN , HIGH=MAIN 
10. ENDCCA 


McP MCPNAME=C7 
CACH=(62,9600, FULL, ILA) 


11.) END 
1. Start of a global network definition. Specifies operator communications. GAWAKE and DCA must be specified 
for all PDNs. 
2. 100 64-word network buffers are used with a threshold of 2 network buffers. 35 activity request packets are 
needed and buffer pool usage statistics are required. 18 user data unit control tables are required, each 28 
words long with a threshold of 2. 
3. Three LOCAP files (Al, A2, and A3) are specified to support three user programs in this processor. All use the 
ICAM standard interface. One priority queue is used on each LOCAP file. 
Figure 3-37. Sample 3-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 
Switched PDN (Part 1 of 2) 
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4. The PDN macro begins the public data network portion of this network definition. The carrier is the DATAPAC 
packet-switched network; level 3 modulus is 8; and packet size is 128. 


5. Defines trunk TRKA; its local subscriber data terminal equipment calling address; and, by default, the number 
of seconds before a data packet timeout (10 seconds). There are 2 permanent virtual circuits on this trunk 
and 2 switched virtual circuits with /O capability. The level 3 window size is 3. 


6. All packet-switched PDns use LAPB except DATAPAC, which can use LAPA. Line speed is 9600 baud, by 
default, and the ID is 62. 


7. This trunk connects to remote subscribers SUBB and SUBC. The call number for each subscriber is given, and 
the procedure category is G. 


8. One permanent virtual circuit is defined for each remote subscriber. Logical channel numbers are assigned. 


9. Two remote LOCAP files (B1 and B2) are described for SUBB. The programs they represent reside in the 
subscriber B remote processor. Each remote LOCAP file has three priority queues for input. The suboperand 
SUBB points to the label of the SUB macro that contains the calling address of remote subscriber B. 


The end user for subscriber C is the terminal TRM1. The terminal is a UTS 20W with a display of 1920 
characters, by default. Subscriber C (SUBC) is a UTS 4020 packet-switched cluster controller with the ASCIl 
address (30,31) of 1. Three priority terminal output queues are defined. 


Note that all communications are carried on by dynamic sessions; therefore, no SESSION macros are used. 


10. Ends the network definition. & 


11. This CACH statement specifies an intelligent line adapter is connected to 62 to handle the PDN trunk. Note 
that this is the identifier specified in the VLINE macro. 


Figure 3-37. Sample 2-Node ICAM Network Definition Coding to Support a DATAPAC Packet- 
Switched PDN (Part 2 of 2) 
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3.6.3. DATEX-L Circuit-Switched Public Data Network 


DATEX-L is the West German circuit-switched public data network. It requires an 
ICAM global network without distributed communications architecture (DCA). 
DATEX-L is the only PDN that does not require DCA. It conforms to the X.21 bis 
recommendation without test leads. DATEX-L uses unique operands on the ICAM 
LINE and TERM macros. 


Macro Operand 


CCA TYPE=(GBL, ,node) 
GAWAKE=Opt ional 
LOCAP TYPE=(STDMCP) 
LINE CIRCSW=(DATEX,n,n) 
TERM DISINEn 
DISOUT=n 


ICAM supports DATEX-L in both dedicated and global networks as shown in the 
following two figures. Figure 3-38 shows a dedicated network and Figure 3-39 shows 
a global network supporting DATEX-L communications lines. The figures are not. 
annotated because communications lines connected to a DATEX-L public data 
network are defined like regular non-PDN communications lines, with the following 
exceptions: 


& * DATEX-L uses UNISCOPE protocol, therefore, you must specify 
DEVICE=UNISCOPE in the LINE macro for the line that connects to the 
DATEX-L public data network. 


¢ The CIRCSW operand in the LINE macro identifies the line that is connected to 
the DATEX-L circuit-switched public data network. You also use it to specify the 
number of 2-way simultaneous links (full duplex) required and how many input- 
only links are required. 


¢ Automatic dialing is always required. A special dialing feature is required as 
described in the ICAM Technical Overview (UP-9744). The DIALER operand 
specifies the location of the automatic dialer. 


e The CALL operand on the TERM macro specifies the “telephone” number ICAM 
uses to connect to the circuit-switched public data network. Normally, you 
specify a telephone number in the LINE macro, however, for DATEX-L, you must 
specify it in the TERM macro. 


¢ DATEX-L requires special UTS 400 terminals. These are available by a request 
for product quotation (RPQ). 
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Figure 3-39. 


CCA TYPE=(STDMCP) , FEATURES=(OPCOM) 

BUFFERS 16,64,2,ARP=20 

LINE DEVICE=(UNISCOPE), 
TYPE=(9608, SYNC, SWCH, AUTO), 
1D=12, DIALER=(8) , INPUT=PRF1, 
CIRCSW=(DATEX,2,@) 
FEATURES=(U48 , 1920) ,ADDR=(21,51), 
HIGH=MAIN,MEDIUM=MAIN , LOW=MAIN, 
CALL=7@0322, DISIN=5, DISOUT=5 
FEATURES=(U400, 1928) , ADDR=(21,52), 
HIGH=MAIN,MEDIUM=MAIN, LOW=MAIN, 
CALL=047 145 , DISIN=3, DISOUT=3 
FEATURES=(U4@, 1920) ,ADDR=(21,53), 
HIGH=MAIN ,MEDIUM=MAIN, LOW=MAIN, 
CALL=744 1293 ,DISIN=18,DISOUT=5 

PRCS LOW=MAIN 

ENDCCA 


CCA TYPE=(GBL, ,A), FEATURES=(OPCOM) 

BUFFERS 16,64,2,ARP=20 

LOCAP TYPE=(STDMCP) , LOW=MAIN, 
HIGH=MAIN, MEOIUM=MAIN 

LOCAP TYPE=(STDMCP) ,LOW=MAIN, 
HIGH=MAIN ,MEDIUM=MAIN 

LINE DEVICE=(UNISCOPE), 
TYPE=(9600, SYNC, SWCH, AUTO), 
ID=12, DIALER=(8) , INPUT=PRF 1, 
CIRCSW=(DATEX, 1,0) 
FEATURES=(U400, 1920), ADDR=(21,51), 
HIGH=MAIN, MEDIUM=MAIN, LOW=MAIN, 
CALL=700322,DISN=5 ,DISOUT=5 
FEATURES=(U4@@, 1920) ,ADDR=(21,52), 
HIGH=MAIN, MEDIUM=MAIN, LOW=MAIN, 
CALL=047145, DISIN=3, DISOUT=3 
FEATURES=(U40@, 192) , ADDR=(21,53), 
HIGH=MAIN,MEDIUM=MAIN, LOW=MAIN, 
CALL=744 1293, DISIN=10, DISOUT=5 

PRCS LOW=MAIN 

ENDCCA 





. Sample ICAM Global Network Definition for DATEX-L Circuit-Switched PDN 
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Section 4 
Incorporating ICAM Features into Your 


Communications System 


4.1. 


4.2. 


Introduction 


This section describes some of the many features of ICAM and how to incorporate 
them into your communications system. Useful features are sometimes difficult to use 
because several areas are involved, and there is no straightforward description to 
show you what you need to do to incorporate them. The following subsections describe 
some of the useful features of ICAM and how to incorporate them into your system. 
Subjects covered include journaling, disk file preparation, incorporating your own 
translation tables into ICAM, and message formatting on a terminal basis. 


Creating Disk Files 


ICAM uses disk files for different purposes, depending on whether you use the 
standard interface or transaction control interface. You define ICAM disk files with 
the DISCFILE macro in your network generation. 


Basically, ICAM disk files are used to hold messages, thereby reducing the amount of 
main storage taken up by network buffers. Messages may be held in a disk buffering 
file or a disk queuing file. 


If you use the standard interface, ICAM queues both input and output messages; you 
can define one or more disk queuing files for this purpose or use main storage 
queuing. 


With a transaction control interface, ICAM queues output messages only; you can 
define a disk queuing file (or files) or use main storage queuing. 


ICAM also requires a disk buffering file with a transaction control interface for input 
messages under the dedicated network. If the network is global, do not define the 
DISCFILE macro with the MSGSIZE operand in the network. 
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If you use the standard interface with either a dedicated or a global network, then you 
may specify a disk file for queuing of input and output messages. Code the DISCFILE 
macros FILEDIV operand. You create queues with the LOW, MEDIUM, and HIGH 
operands of the LINE, TERM, PRCS, and LOCAP macros. The following illustrates 
the files created: 


Standard Disk 
wiorfats INPUT AND Queueing 
(Dedicated OUTPUT (Optional) 


CONTROL 
AREA 





If you use a transaction control interface with a dedicated network, you must specify a 
disk buffering file for buffering of input messages. Code the DISCFILE macro with 
the MSGSIZE operand. You may also specify a disk file for queuing of output 
messages. Code the DISCFILE macro with the FILEDIV operand. You create queues 
with the LOW, MEDIUM, and HIGH operands of the LINE, TERM, PRCS, and 
LOCAP macros. The following illustrates the files created: 


Transaction Co Disk 


Disk 
. Queueing 
Control Buffering OUTPUT (Optional) 
Interface MESSAGES 
(Dedicated) 


CONTROL 
AREA 





If you use a transaction control interface with a dedicated network, you may specify a 
disk file for queuing of output messages. Code the DISCFILE macro with the 
FILEDIV operand. You create queues with the LOW, MEDIUM, and HIGH operands 
of the LINE, TERM, PRCS, and LOCAP macros. The following illustrates the files 
created: 






Disk 
Transaction INPUT AND Queueing 
Control OUTPUT (Optional) 
Interface MESSAGES 
(Global) 






CONTROL 
AREA 
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In addition to defining a disk file with a DISCFILE macro, you must allocate the file 
through OS/3 job control and must assign the file in the job control stream each time 
you execute your program. If you use a global network, you assign the file in the job 
control stream for GUST instead of individual user programs. The file name of the 
LFD statement must match the label on the DISCFILE macro. 
When you allocate the file, you include an EXT job control statement on which you 
identify the file as a system access technique (SAT) file and specify its size in either 
blocks (256 bytes in length) or cylinders: 

// EXT ST,C,,BLK, (256, 1800) 

// EXT, ST,C,,CYL,3 


How you figure out the amount of space to allocate depends on whether you are 
allocating a disk queuing file or a disk buffering file. 


The space allocation for a disk queuing file is based on three factors: 
1. The average size of your messages 
2. The maximum number of messages you expect to have in the file at one time 


3. The amount of space you allocate for the control area with the FILEDIV operand 


of the DISCFILE macro 
Disk queuing = (Average x Maximum number + Control area 
file size message size of messages) allocation 


For example, assume that your average message size is 256 bytes, you expect to have 
no more than 1000 messages in the file at one time, and you specify FILEDIV=5 on 
the DISCFILE macro. 

256 x 1000 = 256,000 bytes or 1000 256-byte sectors 


(This gives you the size of the message area and is the number you use to 
figure out the FILEDIV percentage. See 2.8.) 


Add 5% or fifty 256-byte sectors for the control area 
Total file size = 1050 256-byte sectors 


The EXT job control statement for this file is: 


// EXT ST,C,,BLK(256, 1858) 
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You can also specify the size of the file in cylinders. Cylinder size depends on the type 
of disk you use. Refer to the appropriate reference manual for your disk subsystem. 


Note: You must always allocate at least one cylinder for a disk queuing file. 


To allocate space for a disk buffering file, use this formula: 


Disk buffering _m 
file size n-p + 255 
Cin 256-byte ——— xt 
blocks) 256 
where: 


m 
Is the maximum input message size, in bytes. 


Is the network buffer size, in bytes. 


Is the size of the message header prefix. See the size operand of the 
BUFFERS macro. 


Is the number of terminals in the network. 
For example, assume your largest input message is 2000 bytes, your network buffer 
size is 256 bytes, the size of the message header prefix is 80 bytes, and you have 24 


terminals in your network. 


20000 
+ 255 





256-88 
x 24 (rounded up) = 25 
256 


The EXT job control statement for this file is: 
// EXT ST,C,,BLK(256, 25) 
The example shown in Figure 4-1 is a network definition that illustrates the use of 


both disk buffering and disk queuing files in a network using a transaction control 
interface. The disk queuing file, TRQUE, is used for both line and terminal output 








message queuing and for a process file, PRF1. Input messages go to the disk buffering 


file, TCIFI. 
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1 10 (16 72 
TNET CCA TYPE=(TCI), FEATURES=(OPCOM, OUTDELV) 
BUFFERS 200, 128, ,ARP=35 

LNE1 LINE DEVICE=(UNISCOPE) , TYPE=(240@, SWCH, SYNC, CONNECT) 

TRM1 TERM ADDR=(28,51), x 
FEATURES=(U100,960), x 
LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

TRM2 TERM ADDR=(28,52), FEATURES=(U100,960), X 
LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

TRM3. TERM ADDR=(29,53) , FEATURES=(U100,968), X 
LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

TRM4 TERM ADDR=(29,54), FEATURES=(U100,960), X 
LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

LNE2 LINE DEVICE=(UNISCOPE), X 
TYPE=(2000, SWCH, SYNC), X 
CALL=4408, x 
LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

TRMS. TERM ADDR=(28,51), X 
FEATURES=(U400, 1920), x 
AUX1=(TP,73) 

DLT1 DLIST TRM1,TRM2 

DLT2 DLIST TRM1,TRM2, TRM3, TRM4 

PRE1 PRCS LOW=TRQUE , MEDIUM=TRQUE , HIGH=MAIN 

TCIFI  DISCFILE MSGSIZE=96@ 

TRQUE = DISCFILE FILEDIV=15 


ENDCCA 


Figure 4-1. Transaction Control Interface Network Definition Using Disk Files 


The job control stream shown in Figure 4-2 allocates the disk queuing file and the disk 
buffering file used in the sample network: 


// JOB 
// bvC 
// EXT 
// LBL 
// LFO 
// OVC 
// EXT 
// LBL 
// LFD 


// FIN 


Figure 4-2. 
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ALLOCATE 
68 // V 
ST,C,,CY 
ICAM.DIS| 
TRQUE 


OL DSP456 
L,3 
K .QUEUE 


6@ // VOL DSP456 


ST,C,,BL 
ICAM.DIS 
TCIFI 


K(256,3@) 
K .BUFFER 


Sample Job Control Stream Showing How to Allocate Disk Queuing and Buffering 


Files 
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Controlling the Message Format to Each of Your 
Terminals 


The message format editing facility (format edit) enables your program to send a 
message to a terminal and have the format edit routine format it, (that is, control 

the line width and the number of lines, according to a set of rules you define in an end 
user profile (EUP) macro. When you define your network, you specify an EUP macro 
for each terminal where you want editing performed. The EUP macro is described 


in 2.11. 

Editing is based on criteria you define in an EUP macro as follows: 

1. An EUF parameter lets you specify a set of fixed (implicit) editing criteria for: 
¢ DCT 500 and 1000 series terminals 
¢  Teletypewriter terminals 
¢ UNISCOPE terminals (64- or 80-character lines) 


Or you can specify the editing criteria you want, such as the line width (lw 
suboperand) and, optionally, the number of lines (lines suboperand) before a 
home paper function is sent. If you specify the number of lines, you can also 
specify that control returns to your program when the required number of lines 
are sent (RET subparameter). 


2. An EDT operand lets you specify an additional editing character you may place in 
your message text to signal the end of a line. 


3. An ETB operand lets you specify a 1- to 3-character sequence that you may place 
in your message text to indicate the end of a line in addition to the line width and 


EDT parameters. 


4, ACMWO operand is provided to disable the computer message waiting indicator 
at certain receiving terminals, thus enabling a message display without operator 
intervention. 


Note that if you use the fixed editing criteria for your messages (e.g., EUF=DCT), the 
only additional editing operand you can specify is the single editing character 
specified in the EDT operand. However, if you explicitly specify the line width you 
want, you can specify both the EDT and ETB operand. In this case, actual line width 
is established according to the first of the three criteria satisfied. 
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Journaling 


Journaling is the process of having ICAM create records and write them to disk or 
tape. These records are the raw material the journal utility uses to produce printed 
reports about your network and, if necessary, produce a restart. A restart provides for 
the reconstruction of ICAM disk queues should hardware problems develop. 


To do journaling, you should be concerned with the following three areas: 


¢ The ICAM network definition macros necessary to incorporate the journaling 
feature 


e The necessary message processing routine macros (MPPS) (a routine you build 
into your network definition to specify which records you want journaled, the 
name of the file to receive the records, and the point in time at which the records 
are to be made). 


¢ The journal utility to produce printed reports or affect a restart 


The journal utility produces printed reports that list the text of incoming and outgoing 
messages, the number of messages sent or received, and the extent to which your 
network buffers and activity request packet pools were used. Note that the journal 
utility processes records gathered by ICAM, but the utility operates independently of 
ICAM (that is, it does not require an ICAM environment). Should ICAM fail due to a 
disk problem, the journal utility allows you to recover messages queued on disk for 
transmission. When you request a restart, the journal utility rebuilds the disk 
message queues. Then perform a warm restart to resume message flow. 


To obtain printed reports, three journal utility statements are at your command. Each 
statement is associated with a report. For example, one statement (BSTAT) gives you 
a printed report on the extent of network buffer and activity request packet usage. 
These statements are placed in your job control stream, as is the statement for a cold 
restart. Details of these statements and examples of their use are found in the ICAM 
Utilities Programming Guide (UP-9748). 


Obtaining these printed reports and a restart is the final half of a 2-part process. 
First, you have ICAM create these records and store them in a journal file. 


To create these records, there are certain statements you must include in your 
network definition. To create one of these five record types - journal records - you also 
must write a message processing routine. The message processing routine and your 
network definition are processed as part of the ICAM generation process. 
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4.4.1. 


4.4.2. 


Types of Records 


There are five different types of journaling records you can create. These record types 
and the JRNINIT suboperands of the CCA macro that create them are: 


1. 


Journal Records - Each of these records contains the text of a message sent or 
received, the time and date the journal record was created, and other related 
information. To incorporate, specify the JOURN suboperand. 


ODNR Records - These records are message dequeuing notices. They are 
journaled when a message is dequeued for delivery to a terminal or other user 
program. To incorporate, specify the ODNR suboperand. 


Line and Terminal Performance Records - These records contain the total 
number of messages sent or received by each terminal and the number of times 
each terminal was polled. To incorporate, specify the PERF suboperand. 


Buffer Statistic Records - These records contain the number of network buffers 
used and the frequency they were used. Also listed is your activity request packet 
size and the frequency the packets were used. To incorporate, specify the STAT 
suboperand. 


Restart Records - These records contain a copy of each message as it was queued 
on disk. If ICAM fails due to a disk message queue problem, the journal utility 
can be used to reconstruct the ICAM disk message queue. Then perform a warm 
restart to resume message flow. To incorporate, specify the RESTART 
suboperand. 


Building a Journal File 


As you write your network definition, you include the macros and operands that tell 
ICAM to create the records and store them in the journal file. Crucial to your record 
building process is the JRNFILE macro. This macro defines and names the journal 

file that stores the records. 


Use the following macros and operands in your network definition to create a journal 
file and the records: 


CCA Macro 


You must specify the JRNINIT operand. Code it as JRNINIT= followed by the 
suboperands needed to create the records you want. For example: 


JRNINIT=(PERF, STAT, JOURN, ODNR, RESTART) 
When you select STAT, you also must code STAT=YES in the BUFFERS macro. 


When you select PERF, you also must code STATS=YES in the LINE macro. 
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When you select JOURN, you also must code INPUT=mpps-name in either the 
TERM or LINE macro, and include the JOURN macro in your message 
processing routine. A journal record is written each time the JOURN macro is 
executed. 


BUFFERS Macro 


To create buffer statistic records, specify STAT=YES. This is in addition to the 
STAT suboperand of the JRNINIT operand of the CCA macro. 


JRNFILE Macro 
This macro names and specifies the journal file to which the records are written. 
The name of the journal file is specified by the label you specify for the JRNFILE 
macro, When you want JOURN records, this label] must be an operand of the 
JOURN macro. The journal file is always a system access technique file on tape 
or disk that you code in the JRNFILE macro as: 

TYPE=(SAT, TAPE) 
for a tape file, or 

TYPE=(SAT, DISC) 
for a disk file. 
LINE Macro 


You code STATS=YES to create line and terminal performance records. This is in 
addition to the PERF suboperand of the JRNINIT operand. 


To create JOURN records for all terminals on a line, specify the name of your 
message processing routine in the INPUT operand. Omit the INPUT operand in 
the LINE macro when you want the JOURN records only for particular terminals 
or when you do not want any JOURN records. For JOURN records, you also 
specify the JOURN suboperand of the JRNINIT operand. 


TERM Macro 

You specify the name of your message processing in the INPUT operand to create 
JOURN records for a particular terminal. This is in addition to the JOURN 
suboperand of the JRNINIT operand. 


When you want JOURN records for all terminals on a line, omit the INPUT 
operand in the TERM macro and specify the INPUT operand in the LINE macro. 
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4.4.3. 


4-10 


¢ JOURN Macro 


This message processing routine macro allows you to create JOURN records and 
store them in the journal file you name in the operand of this macro. This file 
name is the label you assigned to the JRNFILE macro. 


For journal records, you also specify the JOURN suboperand of the JRNINIT 
operand, and include the INPUT operand in either the TERM or LINE macro. 


Sample ICAM Network Definition to Incorporate Journaling 


Figure 4-3 is an example of the statements needed in a network definition for 
journaling. 


The shaded portions are the statements that tell ICAM to build records in the journal 
file. With the JRNINIT operand, we indicate we want line and terminal performance 
and buffer statistics records. 


The STAT=YES operand of the BUFFERS macro indicates we want buffer statistic 
records. 


On both line 1 (LNE1) and line 2 (LNE2), we specified STATS=YES to indicate we 
want line and terminal performance records for both lines. 


The JRNFILE macro names and defines the journal file where the records are stored. 
We labeled this macro JRN1; it is coded in operand 1 of the JOURN macro of the 
message processing routines if we decide to produce journal records. We then create 
the journal file on disk by specifying TYPE=(SAT,DISC) in the JRNFILE macro. 


Figure 4-4 is an example of a message processing routine combined with a network 
definition to create and store records. Included in this example is a message 
processing routine. You have a choice of where to place the JOURN macros, but the 
remaining statements, beginning with MPSTART and ending at SENPST, must be 
included and written in the order presented. Otherwise, your message processing 
routine does not function and journal records are not produced. 


In this example, we placed the JOURN macro among the receive and send groups. 
Thus, we create journal records for incoming and outgoing messages on the lines and 
terminals where the INPUT operand is specified. 


By placing the JOURN macro after RECEND, a journal record is created after the 
incoming message is processed. By placing the JOURN macro after SENEND, a 
journal record is created after the outgoing message is processed. You are not limited 
to a single journal record. We could create a journal record for outgoing as well as for 
incoming messages. For more information on the use of the JOURN macro and 
message processing routines, refer to the OS/3 ICAM Programming Reference Manual 
(UP-9749). 
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NET1 CCA PASSWORD=CRG, TYPE=(STDMCP), x 
NER TRETECRERE STATS 
BUFFERS 20, 100, ,ARP#24, STAT=YES 









LNE1 LINE CALL=6461062, X 
DEVICE=(UNISCOPE) , 4 
TYPE=(2000, SWCH, SYNC), x 
STATSSYES) x 
HIGHSMAIN, MEDIUM=DISC1, LOW=DISC2 

TRM4 TERM ADDR=(29,53), x 
FEATURES=(U10@, 1024), X 
PINTV=5@ 

TRM2 TERM ADDR=(29,54), X 
FEATURES=(U1@0, 18), x 
PINTV=5@ 

LNE2 LINE CALL=6460262, X 
DEVICE=( 1004), x 
TYPE=(2400,UNAT,SWCH, SYNC), x 
1D=6, X 
STATSHYES 

TRM3 TERM ANSWER=(5,C,PHIL1), X 
FEATURES=( 1004), x 
HIGH=MAIN 

TRMG TERM ANSWER=(5,C,PHIL2), x 
FEATURES=( 1004), x 
HIGH=MAIN 


PRF1 PRCS LOW=MAIN 
PRF2 PRCS LOW=MAIN 
DIsci DISCFILE FILEDIV=10,F ILESIZE=50 
DISC2 DISCFILE FILEDIV=10,FILESIZE=50 





ENDCCA 


Figure 4-3. Sample Network Definition Showing How to Create a Journal File for Buffer and 
Terminal Statistics 
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1 18 16 Comments 72 
a E 
NET1 CCA PASSWORD=CRG, TYPE=(STDMCP), xX 


JRNINIT=( JOURN) 
BUFFERS 20,100, ,ARP=24 





LNE1 LINE CALL=6461062, x 
DEVICE=(UNISCOPE), X 
TYPE=(2008, SWCH, SYNC), X 
HIGH=MAIN, MEDIUM=DISC1,LOW=DISC2, xX 
INPUT=(MPSA) Journal all terminals 

TRM1 TERM ADDR=(29,53), on line x 
FEATURES=(U100, 1024), x 
PINTV=50 

TRM2 TERM AODR=(29,54), x 
FEATURES=(U1@@, 1024), x 
PINTV=5@ 

LNE2 LINE CALL=6460262, xX 
DEVICE=( 1004), X 
TYPE=(2400,UNAT,SWCH,SYNC), xX 
1D=6 

TRM3. TERM ANSWER=(5,C,PHIL1), xX 
FEATURES=( 1004), xX 
HIGH=MAIN, xX 
INPUT=(MPSA) 

TRM4 TERM ANSWER=(5,C,PHIL2), Journal terminal 3 x 
FEATURES=( 1004), only xX 
HIGH=MAIN 

JRN1 JRNFILE TYPE=(SAT,DISC) No journal for terminal 4 

ENDCCA 
PRF1 PRCS LOW=MAIN 


PRF2 PRCS LOW=MAIN 
DISC1 DISCFILE FILEDIV=10 
DISC2 DISCFILE FILEDIV=10 
MPSA MPSTART THIS IS THE START OF THE MPPS 

RECSEG 

RECHDR 

DIRECT P,PRF1,L 

RECEND 

JOURN JRN1 

RECPST 

SENSEG 

SENHDR 

SENEND 

JOURN JRN1. 

SENPST 

ENDCCA 


Figure 4-4. Sample Network Definition Showing a Message Processing Routine for Journaling 
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Allocating the Journal File 


If you define a journal file in your network definition, you must also allocate the file 
through OS/3 job control and assign the file in the job control stream each time you 
execute your program. (If you use a global network, you assign the file in the job 
control stream for GUST instead of your individual programs.) The file name on the 
LFD statement must match the label on the JRNFILE macro. 


The journal file may be on tape or disk, depending on your TYPE operand 
specification on the JRNFILE macro. 


To allocate a disk journal file, you include an EXT job control statement on which you 
identify the file as a system access technique (SAT) file and specify its size in either 
blocks (256 bytes in length) or cylinders: 


// EXT ST,C,, BLK, (256, 4800) 
// EXT ST,C,,CYL, 10 


To determine the amount of space you need for the disk journal file, multiply the 
average message size by the maximum number of messages you expect to transmit 
during execution of your program. In the case of a global network, the file should be 
large enough to contain the messages for all the programs using the global network. 


If you use a tape journal file, you do not specify a space allocation, but you can assign 
as many tape volumes as you need. To assign a single volume tape file, you include a 
device assignment like the following in your program’s job control stream: 


// DVC 9@ // VOL TAPE@1 // LBL JRNFILE // LFD JRNFILE 
Note that any tape journal file definition in a jobstream LBL statement is not 
mandatory. If you want to specify it, the tape must be initialized with a label 


previously. 


To assign a multivolume tape journal file, you include a device assignment similar to 
the following in your program’s job control stream: 


// OVC 98 // VOL TAPE@1,TAPEQ2,TAPE@S // LBL JRNFILE, TAPEQ1 
// LFD JRNFILE 
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Incorporating Your Own Translation Tables into ICAM 


ICAM allows you to incorporate your own (own-code) translation tables into your 
network. You do this by creating your own translation tables and identifying them in 
the LINE or TERM macros by means of the XLATE operand. 


You construct a translation table by specifying the hexadecimal values you want in 
ascending order. These values are the result of the hexadecimal values of the 
characters to be translated. 


Translation tables usually are 128 or 256 bytes long (0 to 127 or 0 to 255 positions). 
However, they can be shorter if need be. Each character to be translated is converted 
to the hexadecimal value found at the position in the translation table that 
corresponds to the value of that character. 


Example 
You construct the following table that begins: 
@@ C5 25 C1 40 E2 C9 E4 QD C4 DO 01 O5 C6 C3 D2 etc 
The character to be translated is 034, 
then the character is converted to Cl (at the fourth location), 
If the next character to be translated is OAj, 
then it is translated to D9 (at the eleventh location). 
Notice that the converted values reside at the 4th and 11th locations in the 


translation table because the 00 is in the 1st location. 


Figure 4-5 illustrates how to include your own translation tables in a network 
definition using the XLATE operand. 
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NET1 CCA 
BUFFERS 
1. {L1 LINE Per ,XLATE=(INPUTA, 1,OUTPUTA, 1),..- 
2. {T1 TERM Arar ,XLATE=(,OUTPUTB,2),-.- 
3. {T2 TERM sere ,XLATE=(INPUTB,2),..- 
4. jt2 LINE nen , XLATE=(NO),.-- 
5. |13 TERM ...  ,XLATE=CYES,YES),--. 
6. |T4 TERM ema 
7. {L3 LINE tate , XLATE=(, YES),... 
8. 75 TERM ‘eae ,XLATE=( ,OUTPUTC,3),..- 
9. |T6 TERM ae ,XLATE=(INPUTC,3,NO),... 
10.) INPUTA boc XL16! 
F translation table entries 
* normally 256 bytes 
oc XL16! 
INPUTB oc XL16! 
; translation table entries 
pc XL16! 
INPUTC oc XL16! 
translation table entries 
oc XL16! 
OUTPUTA DC XL16! 
: translation table entries 
oc XL16' 
OUTPUTB oc XL16! 
a translation table entries 
oc XL16! 
OUTPUTC pc XL16! 
: translation table entries 
DC XL16" 
ENDCCA 
Figure 4-5. Network Definition Showing How to Incorporate User Own-Code Translation 
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Notes: 


1. Specifies all terminals on Line L1 use translation table INPUTA for input and 
OQUTPUTA for output. 


2. Terminal T1 overrides [61]6 for output. 
3. Terminal T2 overrides {61|6 for input. 


4. Shows that line L2 indicates no translation of input is performed for any 
terminal on that Line; output uses a standard table. 


5. Shows terminal T3 overrides |[64|6 and calls standard translation tables for both 
input and output. 


6. Specifies terminal T4 uses tables as defined by tine L2. 
7. Shows that line L3 uses standard input and output translation tables; the 
standard output table was explicitly called. In this case, the XLATE operand was 


not needed. 


8. Shows terminal T5 calls for a user-supplied output translation table named 
OUTPUTC for output, but it uses a standard translation table for input. 





9. Shows that terminal 16 uses a user-written translation table named INPUTC for 
input, and no translation is performed on output. 


10. Shows how six translation tables were included in a typical network definition. 


Figure 4-5. Network Definition Showing How to Incorporate User Own-Code Translation 
Tables (Part 2 of 2) 
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4.6. How the Statistics Area Tracks Buffer Pool Usage 


When you specify STAT=YES for the BUFFERS macro, the system creates statistics 
areas that record usage of the network buffer pool and the activity request packet 
pool. The format of each area is 12 words of control information followed by one word 
containing the number of deferred requests and one word containing the number of 
requests rejected for lack of available network buffers or activity request packets 
(ARPs). This is followed by the statistics area. The areas are constructed as shown in 
Figure 4-6. 


One full word is devoted to each network buffer or activity request packet in each pool 
and contains the hexadecimal count of the number remaining in the pool after a 
network buffer or activity request packet is used. 


Both the network buffer pool and activity request packet pool use the same DSECT. 
For dump analysis, the location of the particular pool can be obtained by adding the 
beginning address of your network to the value of TN#CARPT for the activity request 
packet pool or to the value of TN#CDTAT for the network buffer pool. 


Figure 4-7 is a sample dump that shows network buffer pool activity. Message traffic 
in this test system was particularly heavy, as can be seen by the fifteenth position 
(word 14) in the pool that shows there were no buffers available 616 times (268) 16. 
Only 137 times during this session were there 39 buffers available, as can be seen by 
the hexadecimal count of 89 in the fifty-fourth (word 53) position (39 + 14). 


UP-9745 Rev. 3 417 





Incorporating ICAM Features 





Bytes 


CONTROL INFORMATION 


NUMBER OF NETWORK BUFFERS/ARPS NUMBER OF NETWORK BUFFERS/ARPS 
GENERATED CURRENTLY AVAILABLE 


CONTROL INFORMATION 








n+ 14 





NUMBER OF TIMES n NETWORK BUFFERS/ARPS AVAILABLE 


Figure 4-6. Network Buffer/ARP Statistics Area Format 
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614 


NUMBER OF TIMES THERE WERE ZERO 
BUFFERS LEFT IN THE POOL 
AFTER A BUFFER WAS OBTAINED (WORD 14) 


NUMBER OF BUFFERS GENERATED) 
(WORD 7) 


NUMBER OF REJECTED REQUESTS NUMBER CUR BER EY GV PIC SeEe 


(WORD 13) 
NUMBER OF DEFERRED REQUESTS START OF 12 WORD CONTROL FIELD 
{WORD 12) (WORD 0) 


001060-00000000 00000000 000G0000 000q0000 odooodoo 0 *) 00000000 OOOOBOFC *........ecceeeeeee 





§ 00000100 00500010 00000003 *...... 
0010A0-0000000 4 10 } 00000134 000000D8 O000008E * 
0010C0-00000062 0000003F 0000001B 00000009 00000007 00000005 00000002 00000002 * 
0010E0-0000000!1 00000001 00000002 00000001 00000001 00000002 00000001 00000003 *............ 
001100-00000001 00000001 00000001 00000001 00000002 00000001 00000002 00000001 *.................. 


001120-00000001 00000002 00000001 0000000! 00000001 00000002 0000002B O000004A *...........-eeeeee 





001140-00000060 090: } 00000001 0000000! 00000002 O00000IC 6FIF7ESA *...-eeecceeceeeece 


NUMBER OF TIMES THERE WERE 
NUMBER OF TIMES THERE WERE 38 39 BUFFERS LEFT IN THE POOL 
BUFFERS IN THE POOL AFTER A AFTER A BUFFER WAS OBTAINED 
BUFFER WAS OBTAINED (WORD 52) (WORD 53) 





Figure 4-7. Statistics Area for Network Buffers or ARPs 
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Section 5 
System Operations 


5.1. Generating ICAM 


You create your communications system as part of the system generation (SYSGEN) 
process outlined in the OS/3 Installation Guide (UP-8839). You can have as many as 
18 different ICAM symbionts that comprise your communications system; you create 
each one in a separate system generation. 


To generate an ICAM symbiont, you code the parameters in the COMMCT phase of 
system generation. There are two types of COMMCT parameters: network definition 
parameters and message control program (MCP) parameters. Both COMMCT 
parameter types are required to generate your ICAM network. Network definition 
parameters are described in Section 2. The MCP parameter format is shown in 5.1.1. 
For a detailed description of MCP parameters, refer to the OS/3 Installation Guide 
(UP-8839). 


After the COMMCT parameters are coded, you submit the COMMCT phase to the 
parameter processor SG$PARAM. The parameter processor validates the 
specifications and produces a listing. You then run the prefiled job control stream 
SG$COMMK to assemble and link the ICAM symbiont into the $Y$LOD library on 
your system resident disk volume. 


The parameter processor provides default values for operands that are omitted or 
incorrectly stated. Certain default values are interrelated; that is, the default values 
for some operands depend on the values you supply for other operands. These default 
values are indicated in the macro formats by shading or are explained in the text. 


You may include more than one network definition in an ICAM symbiont by coding 
multiple sets of network definition macros in the COMMCT phase. The maximum 
number of network definitions for the standard, transaction control, and direct data 
interfaces is four; you may also include one communications physical interface 
network definition. You can code the CCAMOD parameter in place of network 
definition macros if you want to include a network definition that is stored in the 
$Y$SRC library on your system resident volume or the OS/3 release volume. The 
CCAMOD parameter must be followed by ENDCCA. 
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To create an ICAM module containing multiple network definitions, your COMMCT 
phase would look something like this: 


1 72 





COMMCT Phase name 


CCA 
Network definition 1 


ENDCCA 


ENDCCA 


CCA 
. Network definition 2 


CCAMOD=NET 1 
ENDCCA Network definitions filed in $Y$SRC 
CCAMOD=NET2 
ENDCCA 
MCP 
MCP parameters 
END Phase delimiter 


Figure 5-1 illustrates the coding to generate an ICAM symbiont named M3 containing 
three network definitions - one for a standard interface, another for a direct data 
interface, and a third for a communications physical interface. The FEATURES 
operand of the CCA macro is coded only once; these features become part of ICAM and 
are available to all networks. 


Note: You can include one global CCA and nine dedicated CCAs in one ICAM 
network definition. 
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Late een 


COMMCT 


NET1 


LNE1 


TRM1 


PRC1 


NET2 


LNE1 


TRM1 


PIOCS 


END 
//FIN 


CCA TYPE=(STDMCP) , PASSWORD=JHB, 
FEATURES=(OPCOM, OUTDELV) 

BUFFERS 25, 100, 1,ARP=25 

LINE DEVICE=(UNISCOPE) , TYPE=(2400,SWCH, SYNC), 
CALL=555-2726, INPUT=PRC1 

TERM ADDR=(28,51) , FEATURES=(U4G0, 1920), 
LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

PRCS LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

ENDCCA 

CCA TYPE=(DDI,3) 

BUFFERS ARP=24 

LINE DEVICE=(UNISCOPE) , TYPE=(2400, SWCH,SYNC), 
CALL=555-2728 

TERM ADDR=(28,51) , FEATURES=(U4Q0, 1920), 
AUX 1=(TCS, 73,74) , AUX3=(TCS, 75, 76) 

ENDCCA 

CCA —_—USERS=2 

ENDCCA 

MCP 

MCPNAME=M9 

MCPVOL=A12345* 
CACH=(@8, 2400, SWITCHED, SYNC) 
CACH=( 12,2400, SWITCHED, SYNC) 





* Optional volume serial number of system resident volume (SYSRES). 


Figure 5-1. Sample SYSGEN to Generate an ICAM Symbiont 


5.1.1. MCP Parameter Format 


The MCP parameter format follows the SYSGEN coding rules. This differs from the 
network definition macro coding rules. For a detailed explanation of each MCP 
keywork parameter and for guidelines on using the CACH statement, refer to the 
OS /3 Installation Guide (UP-8839). 
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The MCP parameter format follows: 


Cn 


MCP |MCPNAME= | C1 (MCPVOL=vsn] 
Mn 


CACH= 


The CACH statement has three formats. 


Format 1 


CACH=(nn,network-name, 
Line-number ) , CHAN=nn 


Format 2 
CACH=(nn,line-speed |,f FULL 
HALF 


+[ AUTODIAL | ,nn,EON,p 


C,SWITCHEDJL,SYNC] |,f ILA 
x21 1) 


| 2 | [, LDTE=ldte-name] 


Format 3 
CACH=(nn, DIALER[ ,EON]) 


Ts 


Format 4 (for DCPCHNL only) 
CACH=(nn, ,DCPCHNL)[, CHAN=n) 


{BPOOLEXP=NO} 
CFASTLOAD=NO] 


5-4 
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ICAM Initialization and Shutdown 


The ICAM load module you create at SYSGEN is a symbiont. That is, when you load 
it into main storage, it becomes part of the OS/3 supervisor. You must load ICAM 
before you can execute any communications user programs. If you are using a global 
network, you load ICAM, then execute GUST before running user programs. ICAM 
resides in main storage until the last communications user program is terminated 
(unless you specify the KEEP parameter); with a global network, it remains in main 
storage until all user programs are completed and GUST is shut down. Then ICAM 
shuts itself down (unless you specify KEEP). 


The KEEP parameter keeps the ICAM symbiont loaded until cancelled by the system 
operator or if ICAM experiences an unrecoverable error. For example, if you load 
ICAM by keying in: 


C5 KEEP 


ICAM remains loaded after all user programs and GUST are terminated. 


Loading an ICAM Symbiont 
Always load ICAM in an idle system to avoid main storage fragmentation. Load 
ICAM from the system console by keying in the operator command: 


Cn ]ALKEEP} 
Mn 


where: 


Cn or Mn 
Is the ICAM symbiont name specified on the MCPNAME parameter in the 


COMMCT phase of system generation. 


KEEP 
Keeps the ICAM symbiont loaded until cancelled by the system operator or 
ICAM suffers an unrecoverable error. 


You can also load ICAM from a job control stream with the statement: 


// CCA'{ Cn )AKEEP' 
Mn 


This allows you to load ICAM from a workstation instead of asking the console 
operator to do it for you, and it also allows you to load ICAM as part of your IMS 
execution job or as part of a job that executes the global user service task. If you are 
using embedded data in the GUST job, include a JCL // PAUSE command after the 
ICAM CC command. This prevents GUST from issuing the NETREQ before ICAM is 


ready. 
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You can use the CC job control statement in two ways: 
1. Inajob control stream that only loads ICAM: 


// JOB jobname 


//ACCA'f Cn ]AKEEP! 
Mn 


1% 


2. Ina job control stream that executes your program or, if you are using a global 
network, in a job control stream that executes the global user service task. The 
CC job control statement immediately follows the JOB statement. 


When ICAM is successfully loaded, the message 
ICAM 13.@ READY 

is displayed on the system console. 

Notes: 


I. Ifyou load ICAM from a workstation, ICAM messages are still directed to the 
operator’s console. . 


2. Ifyou use embedded data in the GUST job, include a PAUSE command after the 
CC command. This keeps GUST from issuing the NETREQ before ICAM is ready. 


Loading a Communications User Program 


If you use a dedicated network, you can load your communications programs after the 
ICAM READY message is received. With a global network, you execute GUST, then 
your communications programs. : 


You load a communications program the same way as any other user program. That 
is, you submit a job control stream defining the devices, program name, and any data 
associated with your program. You must always assign a printer, and if you have 
requested disk buffering, disk queueing, or journaling in your network definition you 
must include a device assignment for each file you defined. If you use a global 
network, you omit the device assignments from this job control stream and include 
them in the run stream for GUST so they are available to all users of the global 
network. (See Figure 5-3.) 


A job control stream for a communications user program using a dedicated network is 
illustrated in Figure 5-2. For information on allocating disk queueing and disk 
buffering files, refer to 4.2; for details on allocating a disk or tape journal file, 

see 4.4.4, 
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// JOB RECORDS 
// DVC 20 // LFD PRNTR 

// DVC 5@ // VOL DSP456 
*// EXT ST,C,,CYL,3 

// LBL ICAM.DISK.QUEUE // LFD DOFILE 
// DVC 5@ // VOL DSP456 
*// EXT ST,C,,BLK(256, 108) 

// UBL ICAM.DISK.BUFFER // LFD TCIFI 
// DVC 51 // VOL DSP5@ 
*// EXT ST,C,,CYL, 10 

// UBL JRNFILE // LFD JRNFILE 

// EXEC USERPROG 

/$ 


er 4 


data deck 
/* 
/& 
// FIN 


* Remove EXT statements after first execution 


Figure 5-2. Sample Job Control Stream to Execute User Program 


5.2.3. Global User Service Task (GUST) Initialization and 
Shutdown 


Before your program can request attachment to a global network, you must execute 
the GUST program, ML$$GI. You can supply GUST start-up information either 
through embedded data in the job control stream or by replying to messages from the 
system console. Figure 5-3 illustrates a sequence of job control streams for executing 
GUST (without embedded data) and two user programs. 


When a virtual line (VLINE) using X.25 protocol is included in your network, the JOB 
statement for the GUST job must allocate 6000 bytes of main storage. Otherwise, no 
allocation is necessary on the JOB statement. See Figure 5-3. 


All disk and tape files defined in the global network definition with DISCFILE or 
JRNFILE macros must be assigned in the GUST job stream, rather than in the job 
streams for user programs. 


This example assigns a previously allocated disk queueing file and a tape journal file. 
(Refer to 4.2 and 4.4.4 for details on file allocation.) You use the INIT parameter on 
the LFD statement for the disk queueing file if you want to reinitialize the file; omit 
this parameter if you want to continue writing to the same file. The EXTEND 
parameter on the LFD statement for the tape journal file allows you to continue 
writing to a previously established file. By using the job name GUST, the operator 
will know that it is the prefiled name needed to do RU jobname at run time. 
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// JOB GUST 

/ DVC 28 // LFO PRNTR 

// OPTION SYSDUMP 

// DVC 5@ // VOL DSP456 // LBL ICAM.DISK.QUEUE // LFD DQFILE,,INIT 
// OVC 98 // VOL TAPE@1 // LBL JRNFILE // LFD JRNFILE,,EXTEND 
// EXEC MLS$$GI 

/& 

// FIN 

// JOB USER1 

// EXEC USERA 

/k 

// FIN 

// JOB USER2 

// EXEC USERB 

/& 

// FIN 


~ 


Figure 5-3. Sample Job Control Stream to Execute GUST and User Programs 


When GUST is executed, it determines whether to send messages to the system 
console or to retrieve embedded data from the job control stream to obtain information 
needed to load your global network. If embedded data is not present in a job stream, 
the computer operator must respond to each message described in the subsequent 
text. Embedded data consists of GUST commands in the job control stream formatted 
the same as required for console messages. Refer to "Initializing GUST" following in 
this section for data format and Figure 5-4 for an example of GUST with embedded 
data. 


The GUST messages given here are only those pertaining to initialization and 
shutdown. All GUST messages can be found in the current version of the System 
Messages Operations Reference Handbook (UP-8076). 


Initializing GUST 


58 


After the ICAM READY message is received on the system console, GUST may be 
loaded. (When using embedded data, a PAUSE statement before EXEC ML$$GI 
keeps GUST from issuing the NETREQ before ICAM READY. See Figure 5-4.) 


If embedded data is used, the information requested by the MC#420 and MC#421 


messages must appear in column 1 between the /$ and /* of the job control stream. 
(See Figure 5-4.) 
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If no embedded data is used, the following message is sent by GUST: 


MC#420 ENTER NETREQ: CCA,PASS, RESTART, LNEREQ 


Meaning 


GUST is requesting the name, password, restarts, and line information 
associated with the global network to be initiated. Virtual lines (VLINEs) and 
remote workstation (RWS) lines are brought up by GUST automatically. Do not 
specify them as part of the response. 


Response 
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ccaname |,{passwordI(,restart] |,] * 
ACCL,Y] 
line-1{,line-2,...]£,*] 


where: 

ccaname 
Is the name of the global network to be activated. This name must be 
the same as the label of the CCA macro that begins the network 
definition for the global network. 

password 
Is a 1- to 8-character password. 

restart 


Is N or Y. This determines the type of restart GUST requests for the 
network. If you specify Y, GUST sets a restart flag to initiate a warm 
restart, i.e., messages are recovered from existing disk files. If you 
respond N, normal initialization is begun. That is, new disk files are 
created if required. 


Asterisk specifies that line requests are to be issued only to the lines 
specified and that message MC#421 is to be issued to obtain the names 
of additional lines to be activated. 





Uc,Y] 
ALL specifies that GUST is to issue line requests for all lines defined in 
the global network. This is the default situation; if you do not specify *, 
ALL, or line-names in your reply, GUST activates all lines in the 
network using fatal error recovery procedures (that is, if any line 
requests are errored, the network will not be activated). 


If you specify ALL,Y, line errors are treated as nonfatal errors and the 
network is brought up. 
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line-1,line-2,... 
Specifies the local lines for which line requests are to be issued by 
GUST. The names you specify must be identical to those you specified 
in the label field of the related LINE macros. Virtual lines (VLINEs) 
and remote workstation (RWS) lines are brought up by GUST 
automatically. Do not specify them. Since they are brought up 
automatically before notifying interactive services of the ICAM 
existence, it is possible for a direct connect remote workstation to output 
the LOGON message before interactive services is ready to accept the 
open datagram. 


Message 
MC#421 ENTER LNEREQS: LINE-1,LINE-2,... * OR BLANK 
Meaning 


The operator responded to the MC#420 message (or the previous embedded data 
command ended) with an asterisk (*); additional lines can be activated by 
supplying the following: 


Response 
{line-name-1],line-name-2[,...1{,*) 
where: 


line-name-1,line-name-2,... 
Are the names of local lines to be activated by means of line requests. 
GUST issues a LNEREQ statement for each line-name you specify. The 
line-name must be identical to that specified in the label field of the 
related LINE macro. Virtual lines (VLINEs) and remote workstation 
(RWS) lines are brought up by GUST automatically. Do not specify 
them. Since they are brought up automatically before notifying 
interactive services of the ICAM existence, it is possible for a direct 
connect remote workstation to output the LOGON message before 
interactive services is ready to accept the open datagram. 


Signals the GUST program to repeat this request for more line-names. 


If the preceding message is received and no lines are to be activated, you should issue 
a blank character. 
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Message 
MC#430 GUST ACTIVE FOR CCA nnnn 
Meaning 


The network you requested is loaded and ready for processing. No response is 
required. nnnn is the name of the global network loaded. 


Figure 5-4 shows three different ways to execute GUST from a job stream. 


// SOB GUST 
// DVC 20 // LFD PRNTR Execute GUST with 

// OPTION SYSDUMP embedded data to activate 

// PAUSE "WAIT FOR ICAM READY! networks NET1 and all 

// EXEC ML$$GI lines after responding 

/$ to // PAUSE. 

NET1, PASSWORD ,N, ALL 

/* 

/& 

// FIN 

// JOB GUST 

// DVC 2@ // LFD PRNTR Execute GUST with 

// OPTION SYSDUMP embedded data; but activate 

// EXEC MLSSGI only line LNE1 

/$ 

NET1,,N,* 

LNE1 

/* 

/& 

// FIN 

// JOB GUST 

// OVC 20 // LFD PRNTR Execute GUST without embedded 
// OPTION SYSDUMP data. In this case, GUST sends 
// EXEC ML$$GI messages to the operator to find 
1& out how to activate the network. 
// FIN 


Figure 5-4. Three Ways to Execute GUST in a Job Control Stream with and without Embedded 
Data Commands 
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Shutting Down GUST 


All ICAM commands are the same for both dedicated and global networks, with one 
exception. If you issue the following command for a global network, all of your 
programs are canceled with error code 470. However, all outstanding messages to the 
system console must be answered before GUST shutdown can complete. See the 
System Messages Reference Manual (UP-8076) for an explanation of all task cancel 
codes. 


Command 


| Cn jeepers 
Mn 


where: 


80 
Means this message is destined for the supervisor. 


Cn 
Mn 
Is the name of the ICAM symbiont loaded (C1-C9 or M1-M9). 


GU 
Specifies this command is for GUST. 


Specifies a shutdown is required. 

network-name 
Is the name of your global network. It must be the same as the label of the 
CCA macro in your global network definition. If the label is less than four 


characters, pad it with blanks on the right. 


If you enter this command incorrectly, it is ignored, and the following message is 
displayed: 


Message 


MC#40@ GU - - = = + = 5 = = © + + + + INVALID COMMAND 


Meaning 


The blanks are replaced by whatever type-in you entered. You must reenter the 
entire command. 
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If your shutdown request is accepted, the following message is displayed when 
shutdown processing is complete: 


MC#401 GUST SHUTDOWN COMPLETE 


To resume communications processing, repeat the entire ICAM start-up procedures. 
Never cancel the GUST job with the system CANCEL command. If you do so, the 
CANCEL command will be rejected by GUST and the GUST shutdown command 
requested. 


System Console Communications 


Occasionally, the system console operator must communicate with ICAM to change 
the communications environment or to advise ICAM of some external event. The 
console operator does these things via input messages to ICAM entered at the system 
console. We call these messages ICAM console type-ins, and they may be either 
unsolicited commands or responses to ICAM messages. For example, a command is 
issued when the operator puts a line or a terminal down (DO) or reactivates (UP) one. 
A response is always to a console message from ICAM; e.g., when the console operator 
responds to an ICAM request to manually dial a telephone number. 


The descriptions of the ICAM console type-ins are divided into those used for public 
data networks and those used for other communication systems. Refer to the 
System 80 Operations Guide (UP-8859) for all console commands and responses. 
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Section 6 
Terminal Operations 


6.1. 


6.1.1. 
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This section describes how to configure, start up, and shut down ICAM terminals and 
workstations. The instructions explain how to establish and disestablish a dynamic 
session and how to start up and release both local and remote workstations. 


How to Configure Terminals and Workstations for 
ICAM 


Terminals and workstations can be configured in a number of ways: 
e ©Aterminal as a terminal 


¢ A local workstation as a workstation (however, this is not an ICAM-specified 
device) 


e A local workstation acting as a terminal 

e  Aterminal acting as a local workstation 

¢ Aremote workstation 

See Table 6-1 for a summary of system generation and ICAM generation parameters 
and logon/sign-on procedures, 

How to Specify Terminals 

You use the LINE, TERM, LDTE, and RDTE network definition macros described in 
Section 2 to specify terminals used by ICAM. However, in addition to the network 
definition macros, you must specify certain parameters/operands during various 


phases of OS/3 system generation. 


¢ During the SUPGEN phase, you must specify the number of communications 
links (SLCAs) in your system with the COMM parameter. 


¢ During the COMMCT phase, you must specify the MCP parameters described in 
the OS/3 Installation Guide (UP-8839). 
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Table 6-1. Summary of Generation and Logon/Sign-On Procedures for 
Terminals/Workstations 


ee 
poreenfe fe 
fcewn feo 
fae fe 
hem fe 


$$SON to Telcon 
SSOPEN to LOCAP 








$$SON or SSOPEN |Logon required 
to DMI LOCAP $S$SON or SSOPEN 
LOGON to ICAM CUP 


Normal entry Screen mode from [Normal entry 
screen 1 
Workstation mode 
from screen 2 


Normal options -|Normat options - |DCP options - 

req'd on primary|req'd on secondary|req'd on primary 
and secondary for 
terminal spool ing 


Logon required ” 
$SSON or SSOPEN 
to ICAM CUP 


Logon/Sign-on 
Procedure 








































$$SON or SSOPEN 
Entry 


System mode from 
screen 1 
Workstation mode 
from screen 2 









TERM Macro 
AUXn Param 









for terminal 
spooling 
















U200, U400, U2, |U28, U40 
U40 Primary/Secondary |Primary/Secondary 
eet 


io = J. 


TERM Macro 
FEATURES Param 


u20, U40, 1122 

















X'B5' - VLINE ABM 


LINE Macro/ Type=(LWS) Type=(UNISCOPE) | Type=(RWS) VLINE 

VLINE/DCPCHNL DCPCHNL 

BUFFERS Macro Normal Normal Add UDUCT Add UDUCT 
: LINKPAK 


LINKPAK 
* If SIGNON=NO is specified on CCA statement, SSOPEN may replace SSSON for non DCP terminals 


















continued 
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Table 6-1. Summary of Generation and Logon/Sign-On Procedures for 
Terminals/Workstations (cont.) 


| __ Yea workstation Workstation } Terminal emote Workstation emote Workstation | oce terminal | | oce terminal | 


LOCAP Macro 
eden OFF) ae System aes OFF) 


1/0GEN WORKSTATION - REMWORKSTATION |REMWORKSTATION REMWORKSTATION 
Params (Type=3560,3561, Ca 1 } se | 1 } ede 1 } 


1122) 2 2 
AUXPRINTER REMPRINTER REMPRINTER REMPRINTER 


2 


SUPGEN Param COMM for VLINE 
DCPCHNL for 
DCPCHNL 


6.1.2. 








How to Specify Local Workstations 


A local workstation in its native mode does not require ICAM because it is not 
connected to a communications line. It is directly connected to the system. In system 
mode, it has access to interactive services for system commands and job processing. 


Because local workstations are not ICAM devices, they need only be specified in the 
system generation, For completeness of the discussion on workstations and terminals, 
the following description summarizes the things you need to know to specify 
workstations; however, you should refer to the OS/3 Installation Guide (UP-8839) for 
complete information on each of the SYSGEN parameters referenced. 


During the /OGEN phase of system generation, specify: 
e The physical address of the workstation (such as 312, C19) 


e¢ = The type of local workstation as 3560 (UTS 20D single screen) or 3561 (UTS 40D 
or 1122 dual screen) 


¢ Whether an auxiliary printer is to be used with the UTS 40D or SVT 1122; it 
must be specified as AUXPRNTR 


For example: 


1/OGEN 

WORKSTATION ADDR=12 
TYPE=3561 

AUXPRINTER TYPE=0798 
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6.1.3. 


6.1.4. 


How to Specify a Local Workstation to Work as a Terminal 


If you want to use your local workstation as a terminal to communicate with an ICAM 
program, you must specify it in your ICAM network definition as: 


LINE DEVICE=(LWS) 
TERM FEATURES=(U2@), (U4@), or (1122) 


If the auxiliary printer is used on the UTS 40D or SVT 1122, specify it on the TERM 
macro: 


TERM FEATURES=(U4@) ,AUX1=(PRNTR) 
or 
TERM FEATURES=( 1122) , AUX1=(PRNTR) 


The UTS 40D and SVT 1122 local workstations have dual-screen capability. You must 
specify two TERM statements in order for ICAM to use the second screen. 


LNE1 LINE DEVICE=(LWS),LBL=1200 
Ci1A TERM FEATURES=(1122),ADDR=(C11), . . . 
C118 TERM FEATURES=(1122),ADDR=(C11), . . . 


In addition, during the SUPGEN phase of system generation, specify COMM=YES to 
indicate that the ICAM network is to interface with local workstations. Do not specify 
this if there is a combination of terminals and workstations in your network. 


During the YOGEN phase of system generation, specify the parameters/ operands for 
a standard local workstation as described in 6.1.2. 


During the COMMCT phase, specify the MCP parameters described in the OS/3 
Installation Guide (UP-8839). 


How to Specify ICAM Terminals to Emulate Workstations 


If you need to use your ICAM terminals as local workstations, you must specify 
certain parameters/operands during the various phases of OS/3 system generation 
(SYSGEN). The following description summarizes the things you need to know; 
however, you must refer to the current version of the OS/3 Installation Guide 
(UP-8839) for complete information on each of the SYSGEN parameters referenced. 
ICAM network definition macros and operands are described in this guide. 
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During the SUPGEN phase, specify the number of communications links (SLCAs) in 
your system with the COMM parameter. 


During the I/OGEN phase, specify the maximum number of communications 
terminals supported by interactive services with the REMWORKSTATION parameter 
and SCRENMEM-=1. 


During the COMMCT phase, specify: 
¢ ACCA macro that specifies a global network: TYPE=(GBL,,node) 
¢ ALOCAP macro for interactive services: TYPE=(DMI), and IAS=(YES,OFF) 


e TCTUPD=YES in each ICAM UNISCOPE TERM macro that defines a terminal 
for use by interactive services 


¢ DEVICE=(UNISCOPE) on the LINE macro 


e FEATURES=(U20),(U40),(U200), or (U400) on the TERM macro (UTS 30 
terminals are covered under FEATURES=(U40)) 


¢ The MCP parameters described in the OS/3 Installation Guide (UP-8839) 


In addition, make sure your terminals have the field protect feature; otherwise, you 
will get errors when using them to address interactive products. The Interactive 
Services Operating Guide (UP-9972) outlines how to use terminals as workstations. 


6.1.5. How to Specify Remote Workstations 


A remote workstation is a special terminal that has the operating characteristics of a 
local workstation; it is connected to your processor by a communications link to ICAM. 


Remote workstations have two modes of operation: workstation mode and system 
mode. Workstation mode permits communications with user programs using ICAM 
dynamic sessions. System mode allows the remote workstation to use interactive 
services, respond to system messages, and control job processing. 


If you need to use your remote workstations with interactive services, you must 
specify certain parameters/operands during the system generation phase. The 
following description summarizes the things you need to know; however, you must 
refer to the OS/3 Installation Guide (UP-8839) for complete information on each of 
the SYSGEN parameters referenced. ICAM network definition macros and operands 
are described in this guide. 


During the SUPGEN phase, specify the number of communications links (SLCAs) you 
have in your system with the COMM parameter. 
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During the /OGEN phase, specify: 


The maximum number of communications terminals supported by interactive 
services. You specify this with the AMOUNT= keyword parameter following the 
REMWORKSTATION label. 


SCRENMEM parameter on the REMWORKSTATION macro to indicate single- 
or dual-screen devices. 


REMPRINTER for remote printers connected to remote workstations to allow 
remote spoolout. 


During the COMMCT phase, specify: 


You are using a global network. That is, specify a CCA macro as follows: 
cca-name CCA TYPE=(GBL,,node)... 

UDUCT and LINKPAK operands on the BUFFERS macro. 

DEVICE=(RWS) on the LINE macro. 

The PGROUP macro to define a polling group for the workstation. 

On the TERM macro: 

- FEATURES=(U40...) or FEATURES=(U20 ...) specifies the kind of remote 
workstation. If the workstation has a dual screen, specify the PRIMARY or 
SECONDARY suboperand of the FEATURES operand. 

- AUXn defines auxiliary devices attached to a terminal for use by ICAM 
application programs or by the remote spooler. For remote spooler use, 


specify SECONDARY on the FEATURES operand only. 


The MCP parameters described in the current version of the OS/3 Installation 
Guide (UP-8839). 


Note: The TCTUPD operand should not be specified. 


In addition, make sure your workstations have the field protect feature; otherwise, 
you will get errors when using them to address interactive products. The Interactive 
Services Operating Guide (UP-9972) outlines how to use terminals as workstations. 
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6.2. Establishing a Terminal Dynamic Session 


ICAM processes terminal operator requests to dynamically establish or enda . 
communications session. The terminal operator enters sign-on or sign-off commands 
when it is necessary to communicate with a user program, a process file, another 
terminal in the network, or to end a session with one of these. Standard terminal 
dialog is available with global networks that provide dynamic session establishment. 


When the command processor receives a valid sign-on command, the following 
message is sent to the initiating terminal immediately: 


UNISYS DCA NETWORK, LEVEL n.n NODE ID xxxx 
where: 


nen 
Is the operating system release level. 


XXXX 
Is the global network node identifier you specified in the TYPE operand of 
the CCA macro in your network definition. 

@ If the sign-on request is honored, the following message is sent to the initiating 
terminal; and if the session is between terminals, the two messages are then sent to 
the requested terminal: 

SESSION PATH OPEN 


If the request for session establishment is rejected, the following message is sent to 
the initiating terminal: 


SESSION PATH CLOSED 


If a request for sign-off of an established session is issued by another terminal or user 
program, the following messages are sent to your terminal after disestablishment: 


SESSION PATH CLOSED 
SSSOFF 


If your program aborts an established session, the following message is sent to the 
affected terminal: 


SESSION PATH ABORTED 


If an invalid command is entered at a terminal, the following message is returned to 
the terminal: 


6 INVALID $$ COMMAND 
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6.2.1. Sign-on Commands 
The sign-on command depends on the SIGNON operand specified in the CCA macro. 
¢ IfSIGNON=YES, you must use the $$SON command. 


° IfSIGNON=NO, you may use the $$OPEN command. 


SSSON Command 


This command enables you to establish a session with a user program, process file, or 
another terminal when the SIGNON=YES operand is specified in the CCA macro. 


Format 
S$SONAxxxxyyyy 
where: 


A 
Is the required space. 


XXXX 


Is the logical name of the terminal from which you issue this command (that 
is, the label of the TERM macro with which you defined the terminal in your 
network definition). 


yyyy 
Is the logical name of one of the following: 


* auser program (as defined in the label of a LOCAP macro you defined 
in your network definition) 


* aprocess file (as defined in the label of a PRCS macro) 


* another terminal (as defined in the label of a TERM macro) 
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SSOPEN Command 


This command enables you to establish a session with a user program when the 
SIGNONE=NO operand is specified in the CCA macro. You do not need to specify the 
terminal name. This command is valid only from a non-DCP terminal. 


Format 
$SOPENAyyyy 
where: 


A 
Is the required space. 


yyyy 
Is the name of the user program as defined in the label of a LOCAP macro 
you defined in your network definition. 


To sign off a session established with the $}0PEN command, you must issue the 
$$SOFF command. Entry of anew $$OPEN command does not automatically close 
the existing session. 


6.2.2. Sign-off Command (SSSOFF) 


Enter $$SOFF to end a dynamic session. 
Format 


SSSOFF 
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6.3.1. 


6-10 


How to Log On a Workstation 


ICAM supports local workstations, remote workstations, and terminals used as 
workstations. Local workstations are directly connected by cable to the IOMP channel 
of the computer to execute interactive service commands, enter jobs, etc. without 
having ICAM in the system. However, local workstations may be used to 
communicate with user-written programs or IMS in workstation mode using ICAM. 
Remote workstations are connected to your computer by communications lines; 
therefore, ICAM must be present before any communications can begin. These three 
situations require slightly different startup procedures. 


Startup Procedures for a Local Workstation or a Local Workstation 
Used as a Terminal 


When you start up a local workstation, perform the following steps: 
¢ LOGON/Sign-on 


You must enter a LOGON command before you use a local workstation, whether 

you are going to use system mode to interactive services, or workstation mode to 

one of your programs or IMS. If you are using the workstation as a terminal, you 
must LOGON and then sign on to the user program locap or other terminal. 


The $$SON (or $$OPEN) for screen 1 is done from system mode. For UTS 40D 
and SVT 1122 local workstations, a $$SON (or $$0PEN) may be done on screen 2 
from workstation (data) mode. 


¢ = Allocate the local workstation to ICAM (if necessary) 


If you need to communicate with one of your programs or IMS, you must allocate 
the local workstation to ICAM. ICAM attempts to secure workstation mode when 
a line request (LNEREQ) is issued for a local workstation as follows: 


- Ina dedicated network, the using program issues a line request as part of a 
network request (NETREQ), or explicitly requests the line (LNEREQ). 


- Ina global network with static sessions, the line request is issued during 
GUST processing. 


- In aglobal network with dynamic sessions, the line request (LNEREQ) is 
issued when a sign-on command ($$SON or $$OPEN) is entered. 


e Iffor some reason, the local workstation is not allocated by one of these methods 
or the line is marked down, you can force the line request by having the console 
operator issue an unsolicited console type-in (UP command) to activate the local 
workstation line. 
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Since all /OGEN-specified auxiliary devices are allocated to ICAM when an ICAM 
applications program attempts to downline load a program to a local workstation, you 
may want to return these devices to the system when downline loading is complete. If 
an initiate confidence test (ESC Q) occurs during downline loading, the auxiliary 
devices should be deallocated; otherwise, the terminal operator should press RESET. 


6.3.2. Remote Workstation Startup Procedures 


Remote workstations are supported only in global networks and require the use of 
dynamic sessions. They are essentially communications terminals and always require 
the use of ICAM. 


e¢ During GUST initialization, GUST issues a line request to each remote 
workstation line. 


- Ifthe remote workstation is on a private line, polling begins immediately. 
The remote workstation is in workstation mode. 


- Ifthe remote workstation is on a switched line (dial in or dial out), make the 
phone call when convenient. When the connection is complete, the remote 
workstation is in workstation mode. 


¢ Because a remote workstation provides you with both system mode and 
workstation mode, separate concurrent dynamic sessions can be opened. 


-  Toestablish a system mode session, enter a LOGON command in system 
mode, or press the transmit key (or any function key) to have the LOGON 
menu displayed. Once the LOGON procedure is complete, use the terminal 
in the same manner as a local workstation. 


-  Toestablish a workstation mode session with one of your programs or IMS, 
enter a $$SON (or $$OPEN) command from system mode. 


- When the UTS 40 single station or UTS 40 CP/M (with the current prom 
cartridge) is being used as a UTS 40 remote workstation and auxiliary 
output is flowing, the terminal must not be placed in system mode. That 
would cause an error condition; the auxiliary output would never complete. 


- Aremote workstation terminal operator will receive a SESSION PATH 
CLOSED message at the remote workstation when first attempting to 
establish a system mode session if interactive services has not attached (via 
NATTACH) to ICAM and established itself as an ICAM user. The terminal 
operator should wait a few seconds before retrying the command (transmit, 
function key, or system mode request); if resources are available, the 
expected response will eventually be displayed. 


¢ Ifaremote workstation goes down, it can be reactivated by the unsolicited type-in 


UP command. However, you must repeat the entire startup procedure (LOGON, 
$$SON, $$OPEN). 
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6.3.3. 


Startup Procedures for a Terminal Used as a Workstation 


ICAM supports terminals as workstations in a global network environment only, and 
only with dynamic sessions. The following describes how to start up a terminal used 
as a workstation. 


Normally, a line request is issued during GUST processing to activate the 
communications line. The GUST program asks the console operator which lines 
to activate, and issues line requests based on the response. 


- Ifthe terminal is on a private line, polling begins immediately. 


- Ifthe terminal is on a switched line (dial in or dial out), make the phone call 
when convenient. 


To establish a dynamic session with interactive services, enter a $$SON (or 
$$OPEN) command using the demand mode interface (DMI) locap file name as 
the to name. Then: 


- After interactive services displays an OS/3 logon, proceed following the 
instructions provided by interactive services. 


- After you have signed on to interactive services, you can no longer use the 
terminal to communicate with IMS or one of your standard interface 
programs until after you issue a $$SOFF command. 


Interactive services simulates both workstation mode and system mode. To enter 
system mode, press the message wait key. 


6.4. How to Release a Local Workstation from ICAM 


You release a workstation from ICAM as follows: 


612 


If your workstation is defined in a dedicated network, execute a NETREL or 
LNEREL command from your program, or enter a DO command from the 
operator’s console. 


If your workstation is defined in a global network and the workstation is linked 
to ICAM by a static session, issue a NDETACH macro from your program or 
enter a DO command from the system console. 


If your workstation is defined in a global network and is linked to ICAM by a 
dynamic session, issue a $$SOFF command in workstation (data) mode from the 
workstation, or execute an NDETACH macro from your program, or enter a DO 
command from the operator’s console. 


Note: To terminate the ICAM session on a dual-screen device, issue the $$SOFF 
command in workstation mode from the appropriate screen. 
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Appendix A 
Relating Telcon and ICAM Networks 


A.1. Overview 


This appendix assumes that you have already defined your physical network, and that 
you know where your host computer or computers and DCPs will be located, where 
your terminals will be located, which models you will use, what types and capacities of 
communications lines you will use, and so on. All those and other essential aspects of 
network design are outside the scope of this supplement. 


Do not use this appendix exclusively. Use the current version of the OS 1100/DCP 
Series, Communications Delivery Software Configuration Guide (UP-9957) for 
specifics. Although this manual was not originally designed for use with OS/3, the 
term CMS 1100 can be used interchangeably with the term OS/3 ICAM. 


This appendix contains the following information to help with your Telcon and ICAM 
generations: 


e §=6© A list of the related Telcon statements and ICAM macros you need to define and 
generate a functioning Telcon and ICAM network. It must be able to support 


DCA Communications Network Software, Communications Delivery Level 2R2M 
and above. 


* A table showing the relationship between the Telcon statements and ICAM 
macros 


e An explanation of how Telcon terminal operation differs from that of OS/3 
e Network configuration examples 
e General comments and restrictions 


e =6Alist of additional documentation required to create the physical configuration 
for Telcon and OS/3 ICAM networks 
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A.2. 


A.2.1. 


A.2.2. 


A-2 


Telcon Network Definition Statements (NDS) 
This section lists and explains the Telcon statements that relate to OS/3 ICAM 


macros. Use the current version of the OS 1100/DCP Series, Communications 
Delivery Software Configuration Guide (UP-9957) for details. 


CHANNEL (I/O Interface) Statement 


Description 


CHANNEL statements define the channel connections between network 
processors and external devices containing a termination system. 


Format 


name CHANNEL TS=parnt,PPID=(ppid[ ,bppid]),; 
[,HBTIM=hbt] (,MODE=(mode,[n1])] (,WINDOW=1] [,STATUS=status] 


ICAM Related Features 
The CHANNEL statement corresponds to the ICAM DCPCHNL macro. 


The TS name must match the label on the DCATS statement identified as the 
host to which this channel is connected. 


The WINDOW value must equal 1 for OS/3 ICAM. 


ICAM does not support any form of resiliency. 


DCATS (External Termination System) Statement 
Description 


DCATS statements define all external devices connected to a Telcon system that 
contain a termination system or systems, i.e., hosts or DCA terminals. 


Format 


name DCATS PRCSR=prc,; 
(,RESIL=bdep] (,CRITL=critl] [FLOWCTRL=flowctrl] 


ICAM Related Features 
OS/3 ICAM cannot refer to a full name that exceeds four characters. 
OS/3 ICAM does not support any form of resiliency (RESIL, CRITL). 


See REMOTE operand of the ICAM LOCAP, LPORT, and TERM macros. 
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A.2.3. 


A.2.4. 


DCPTS (Termination Systems within a DCP) Statement 
Description 

DCPTS statements define termination systems within network processors. 
Format 

name DCPTS PRCSR=pre 
ICAM Related Features 

OS/3 ICAM cannot refer to a full name that exceeds four characters. 


See REMOTE operand of the ICAM LPORT and TERM macros. 


DEVICE Statement 
Description 


DEVICE statements define auxiliary devices, such as printers and paper tape 
units, that are attached to terminals or clusters. 


Format 


name DEVICE TERM=parnt ,TYPE=dtyp, ADR=(adr1[,adr2]) 
CLSTR=parnt 


ICAM Related Features 


See AUXn operand of the ICAM TERM macro. 
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A.2.5. 


A.2.6. 


A4 


SESSN Statement 


Description 


SESSN statements define sessions between communications system users. They 
set up the interface between the transport network and the termination system. 


Format 


name SESSN TS1=(tsn,lsch,adcp[ ,bdcp]), TS2=(tsn, | sch, adep{ ,bdcp]); 
[,PROG1=(pfcop,pfcak,csun,tx)]; 
[,PROG2=(pfcop,pfcak,csun, tx) J; 
C,PRI=priJl,ASPC=aspe) 


ICAM Related Features 


If the TS1/TS2 tsn parameter is defined as the DCATS for the OS/3 host, the lsch 
parameter for that TS1/TS2 must correspond to the PORT operand on the ICAM 
LPORT macro. 


ICAM supports only DTP sessions. 


Note: Because Telcon maintains a balance of sessions across the logical paths, the 
number of SESSN statements issued should be based on the maximum number 
of sessions active at any one time. At least one SESSN statement should be 
generated for every 20 active sessions. For example, if 100 sessions are active, at 
least & session statements should be issued. 


STATION Statement 


Description 


STATION statements define all UDLC stations asséciated with a LINE or 
GROUP. 


Format 


GROUP=parnt 
RSHLE=(rshlef[ ,hque]); 
C ,MODE=modeJ{,LSTYP=(lstyp)]; 
(,LSA=lsaJ; 
(,RSA=rsa][,RS10=rsio}; 
C,CFTYP=cftyp]£,WINDOW=(swin, ithr) J; 
(,GSA=gsal(,DTEID=dteid][,STATUS=status]; 
C, TYPECODE=typecodeJ[ ,REVISION=revision][ , SUBNETID=subnetid]; 


name oy LINE=parnt } 
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ICAM Related Features 


The RSHLE field must match the DCATS name associated with the OS/3 host. 
The LSA field must match the CMDADDR operand of the ICAM VLINE macro. 


The RSA field must match the RSPADDR operand of the ICAM VLINE macro. 


A.2.7. TERM Statement 


Description 


Format 


TERM statements define terminals. 


GROUP=parnt 


name TERM] PRCSR=parnt 


CLSTR=parnt 
SITE=parnt 


TYPE=( type) 
{,DEST=dest] <or> [£SESSN=(sname,endno, [sesend})]; 
r ADR=(rid, sid) (er 

PPID=ppid 
L,BFSZ=(ibs,obs) 1{ ,OPTH=opthI[ ,OCRD=ocrd]; 
{,BELL=bell1{£,FMT=(rows,cols[{,dens])); 
[, SBYPS=sbypsJ[ ,KATK=katk][,MASTR=mastr 1; 
(,AUTH=auth]; uor> [,AUTH=auth,name]; 
(, OPDS=opds][ , CEDS=ceds][ ,RECEIVE=recv]; 
C,MRT=mrt)C,DVCN=dven][,CDC=cdeJ{ ,ECHO=echo); 
L,MTC=mtc][,LDC=ldeJ[, TIMEFILL=(tfc,cr,lf,ff,ws)]; 
{,CVC=cvcJ[{ ,CMSGS=cmsgs][ , COMP=comp][,ERI=erij]; 
C, TIMEQUT=t imeout J[, COMPRDID=did][ ,PCHAR=(start,stop)]; 
( AUTOLF=autol f1[,STATUS=status]; 
[ ,DUALSCRN=dual sern] 


ICAM Related Features 
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OS/3 ICAM restricts terminal names to four characters. If the Telcon term-name 
is more than four characters, you must use the OS/3 ICAM PSEUDO keyword on 
the OS/3 TERM macro. 


Using the Telcon ALOC and DEST fields allows you to have a static-like session 
with OS/3. The terminal operator does not need to $$SON or $$OPEN. Telcon 
static sessions and ICAM static sessions are not supported under DTP protocol. 
See the descriptions for ALOC and DEST. 


AS 
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A.2.8. XEU Statement 


Description 


XEU statements define a CSU (LOCAP) associated with OS/3 ICAM or an 
external end user. Enter each XEU statement once in a configuration and it will 
be included automatically in all DCP configurations. 


XEU statements are used only with the dynamic system session establishment 
feature. 


Format 


name XEU [(CSU=csu][,DPP=dpp] [,DCATS=ts1], <or> [,TS=ts1], <or> [,TS=(ts1,...,tsn)]; 
{,SRCTSU=srctsu]; 
{,DESTTSU='desttsu']; 
{,DESTSSU='destssu']; 
{ ,DESTASU='destasu' J]; 
(, TPFAC=tpfac] or [,TPFAC=(tpfac,...,tpfac)]; 
C, TPDU=(racnt,mrcnt)]; 
{, TIMEQUT=t imeout J 


ICAM Related Features & 





The name or DESTSSU must match the name on the ICAM local LOCAP or 
TERM macro. 


The SRCTSU, DESTTSU, and DESTASU parameters should use defaults. 


The name or DESTSSU and application ids you choose cannot exceed four 
characters. 
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A.3. ICAM Macroinstructions 


This section describes the macros needed to support a Telcon network. Each format 
includes only those operands needed for this environment. 


Macro Description 

BUFFERS Establishes network and activity request packet pools and 
creates other resources needed by ICAM 

CCA Identifies the beginning of a network, the type of network, 
ICAM features, and journaling requirements 

DCPCHNL Defines the CHANNEL physical connection between an OS/3 
host and a Telcon DCP. 

ENDCCA Indicates the end of a network definition 

LOCAP Creates a LOCAP file for your programs that use global 
networks 

LPORT Defines a logical path between DCA transport service users 

TERM Defines the characteristics of each terminal 

VLINE Defines the UDLC physical connection between an OS/3 host 
and a Telcon DCP 


Table A-1 shows the order of presentation of the macros in a DCA Telcon 
environment. 


Note: Before starting to define your ICAM network, refer to A.4 for the operands that 


must match those in the Telcon network. The composition of macros in the 
following sections will differ from those in Section 2. 


UP-9745 Rev. 3 A-7 





Relating Telcon and ICAM Networks 





A8 


Table A-1. Order of Presentation for Macros in a DCA Telcon Network Environment 


Macro Name } Remarks 


CCA 


LOCAP1 Identifies all local user programs and I/S, DDP, TIP, IMS users in this 
F computer host. 
LOCAPn 


Specifies characteristics of all locat lines connected to an 0S/3 host. 


Specifies characteristics of all terminals on this line. 


DISCFILE1 Specifies disk files used for this network. 


DISCFILEn 


Specifies all process files in this network. 


Specifies all static local sessions between local end users. 
(Local means in this computer host - LOCAP1 and PRCS1.) 


VLINE or Identifies physical connection between an OS/3 host and a Telcon front end 
DCPCHNL processor (DCP). It can be a UDLC or CHANNEL connection. 


LPORT1 Identifies all local end users (and remote end users if they reside in 
: another host) and assigns a logical port number to each. 
LPORTn 


LOCAP1 Identifies all DDP, I/S, TIP, IMS, and remote user programs that reside in 
: another host. 
LOCAPn 


TERM1 Identifies all remote terminals that are physically connected to a DCP via 
: Telcon lines or connected to another host. 
TERMn 


Fevocea | Identifies the end of this network definition. 
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A.3.1. How to Specify Buffer Pools, Activity Request Packet Pools, and 
Other ICAM Resources (BUFFERS) 
Use the BUFFERS macro to create a network buffer pool, an activity request packet 
pool, a link buffer pool and a user data unit control table pool (UDUCT). All pools are 
located within your network communications control area. You may also specify 


statistical areas to keep track of ICAM use of the pools so you can adjust pool sizes 
according to your needs. 


Specify this macro only once in each network definition. 


Format 





OPERAND 






LABEL SOPERATIONA 


BUFFERS 





not used Cnum,size}[, thresh] ial n lia 
22 






{, LINKPAK=(num,size{,thresh])] 


{,STAT=YES] 
C,UDUCT=(num[,, thresh])] 


The following describes what is required to support a Telcon network. See 2.2 for 
additional operands and details. 


Operands 
num 
Specifies the number of network buffers you want in your network buffer 


pool. See 2.2 for details. 


size 


Is the length of your network buffers in 4-byte words. See 2.2 for details. 


thresh 
See 2.2 for details. 
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BUFFERS 


ARP=integer 
Creates an activity request packet pool. The number you specify is the 
number of 14-word (56-byte) activity request packets available to ICAM to 
perform its functions. 


To determine the integer value for DCA sessions supporting Telcon, DDP, 
and processor-to-processor configurations, add: 


6 for ICAM 
6 per VLINE/DCPCHNL 
1 for each session allowed 


Note: DMI users should allow 2 per interactive services sessions and 2 per 
DDP session. 


EXPFACT=n 
Specifies an ICAM buffer pool expansion factor. You may specify 0 to 100 
(percent). See 2.2 for details. 


LINKPAK=(num, size[, thresh]) 
Specifies the number, size, and threshold value of link buffers. Use these 
with distributed data processing, RWS support, public data networks, 
TELCON, and processor-to-processor networks. 


num 
Specifies the number of link buffers. Use the following formula to 
determine the maximum number required: 


num = (mpm x maxsess) + 1/2 maxsess 


where: 

num 
Is the number of link-buffers for this network. 

mpm 
Is the number of link buffers required to hold the largest 
message passed over a UDLC line/DCPCHNL. Compute mpm 
by dividing the length of the largest message by the value 
specified in the mxdta parameter on the size of formula 
(rounded to the next whole word). 

maxsess 


Is the maximum number of sessions that will be active on a 
UDLC line/DCPCHNL at any given time. 
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size 
Specifies the length of the link buffer in words (one word equals four 
bytes). Specify either 80 or the results of following formula, (use the 
larger of the two): 


size = (prfxhdr + mxdta)/4 


where: 

prfxhdr 
Is the length of the link buffer prefix plus headers (74 bytes if 
VLINE is used; 84 bytes if DCPCHNL is used.) 

mxdta 
Is an average data size (bytes) to be transmitted. Larger 
output will be broken into segments. 

4 
Converts prfxhdr and mxdta to words. 

thresh 


Specifies a threshold value. Use the following formula: 
thresh = 10% of value specified for num 


Note: numand thresh will decrease when size increases. 


go (num) 


Specifies the number of 3-word timer stack entries used with Telcon, 
processor-to-processor, and distributed data processing. Maximum number 
needed should equal the number of ports plus the number of active sessions. 
The default value is 50. 


STAT=YES 
Creates network buffer pool and activity request packet pool statistics areas 
that keep track of pool usage. 


UDUCT=(num, , {thresh]) 
Specifies the number of user data unit control tables. They are always 28- 
word areas that control data transmission and supply information about 
messages (senders, receivers, ports, and sessions) in Telcon, processor-to- 
processor networks, distributed data processing, and remote workstations. 


For non-RWS configurations, allow at least 1 1/2 times the maximum 


number of sessions which would be active at any given time. Set the thresh 
value to 10% of num. 
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A.3.2. How to Indicate the Start of the Network Definition and Specify the 
General Network Characteristics (CCA) 


This macro identifies the beginning of an ICAM network definition, and the type of 
network and support you want ICAM to provide in the network. 


Format 
LABEL AOPERATIONA OPERAND 


network-name CTYPE=(GBL, ,node)] 


[,DCA=YES] 
[, DCPLOAD=YES] 


,FEATURES= (£,0PCOM] 
[ ,OUTDELV]) 


[,GAWAKE=YES) 





The following describes what is required to support a Telcon network. See 2.3 for 
additional operands and details. 


Label 





network-name 
Is a1- to 4-character label beginning with an alphabetic character that 
identifies this network. This is the name the global user service task 
(GUST) needs to activate your global network. Do not use labels beginning 
with LD or LT. These prefixes have special meaning for system generation. 


Operands 
TYPE=(GBL, ,node) 


GBL 
Indicates this is a standard interface global network definition. Two 
commas must follow the GBL operand. 


node 
Is a1- to 4-character computer node identifier for the computer in which 
this network operates. Any non-null character string that begins with 
an alphabetic character may be specified. This identifier must not 
match the label field of any other macro within the network definition. 


DCA=YES 
Indicates support of distributed communications architecture (DCA). Note 
that you must also specify GAWAKE=YES. 
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DCPLOAD=YES 
This operand must be included if a DCP is to be downline loaded or cross- 
channel loaded by ICAM, or if a Telcon dump is to be captured by OS/3 and 
written to tape for later processing on an 1100/2200 system. 


FEATURES= 
OPCOM 
Includes routines necessary to support unsolicited console type-ins to 
ICAM. This feature is not supported for NTR networks. 


OUTDELV 
Includes routines to support the ICAM output delivery notice feature. 


GAWAKE=YES 
Includes the routines to support the ICAM GAWAKE feature. The 


GAWAKE feature enables any task to activate an ICAM user program that 
has yielded, and optionally send to the user program a message known as a 
datagram. 


If you want dynamically established sessions in your global network, specify 
this operand. 
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A.3.3. 


A-14 


How to Specify DCP Channel Characteristics (DCPCHNL) 

The DCPCHNL macro generates a link vector table that enables ICAM to record and 
control the Telcon DCP channel activity. One DCPCHNL macro is required for each 
Telcon front-end processor connected to the System 80 Model 8, 10, 15, or 20. 


Format 








AOPERATIONA 





LABEL OPERAND 











channel - OCPCHNL 


name 





CNID=channel -number, 
10=subchannel - address, 
REMOTE=dest inat ion-node 


The following describes what is required to support a Telcon network. See 2.7 for 
additional details. 


Label 


channel -name 
Specifies a 1- to 4-character identifier of the channel connecting OS/3 to the 
DCP. This name must be the same identifier specified in the LINE operand 
of the LPORT macro and used in console commands relating to this channel. 


Note: 1, 2, 3, 6, and 7 are valid channel numbers for models 8-20. 
Operands 


CNID=channel -number 
Specifies the channel number in the range of 1-6 as specified in the CACH 
macro of COMMCT. 


ID=subchannel - address 
Specifies the control unit address as specified for the reporting line number 
in the CACH macro of COMMCT. This address is strapped by a customer 
service engineer into a memory board of the channel interface in the DCP 
according to your request. Although the value is strapped in hexadecimal, it 
is specified in decimal for ID= with valid values of 8 to 15. 


REMOTE=dest inat ion-node 
Specifies a 1- to 4-character name for addressing the Telcon front-end 
processor connected to the System 80 host. The name must be the same as 
the name field of the Telcon DCPTS statement. 


Telcon Related Features 


The WINDOW on the Teleon CHANNEL statement must be set to 1. 
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ENDCCA 


ee 


A.3.4. How to Indicate the End of Your Network Definition (ENDCCA) 
This macro indicates the end of a network definition. 


Format 


LABEL AOPERATIONA OPERAND 


not used ENDCCA not used 
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A.3.5. How to Create a LOCAP File for Global Networks (LOCAP) 


This macro creates a local (in this computer) or remote (in a different computer) 
LOCAP file for programs that use a global network. 


Format 


LABEL AOPERATIONA OPERAND 


TyPE=(( STDMCP )) 
DMI 
Tcl 


[, IAS=(YES,OFF)] 
,LOW={ MAIN 
filename 
,MEDIUM=[ MAIN 
filename 
,HIGH={ MAIN 
filename 


[ ,REMOTE=(node) } 





LOCAP -name 





The following explains what is required to support a Telcon network. See 2.15 in this 
manual for additional operands and details. 


Label 


LOCAP-name 
Identifies a LOCAP file. It is the name your program must specify in the 
APPS operand of an NATTACH interface macro when it requests 
attachment to this global network. Other communications user programs 
direct messages to this LOCAP file by this label. 


Operands 





Sais. ies the standard interface used to communicate with this LOCAP file. 


TYPE=(DMI) 
Specifies the demand mode interface used to communicate with this LOCAP 


file. Required if ICAM supports interactive services to allow terminals to be 
used as workstations, or for distributed data processing users. 
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TYPE=(TCI) 
Specifies the transaction control interface for the information management 
system (IMS) or TIP. 


IAS=(YES, OFF) 
Specifies that interactive services are required (YES) but DICE is not (OFF). 
When TYPE=(DM)) is specified, use this operand. 
LOW, MEDIUM, and HIGH 
Generates up to three input queues for messages destined for this LOCAP 
file. At least one of these queues is necessary for direct communications 
between your programs in a local or multicomputer global network, or if any 
terminals specify this LOCAP file in the INPUT operand of the TERM 
macro. 


LOW=MAIN 
Creates a main storage input queue with low priority. 


LOW=f i lename 
Specifies a 1- to 7-character name of a disk file for low priority messages 
you created using a DISCFILE macro. 


MEDIUM=MAIN 
Creates a main storage input queue with medium priority. 


MEDIUM=f i Lename 
Specifies a 1- to 7-character name of a disk file for medium priority 
messages you created using a DISCFILE macro. 


HIGH=MAIN 
Creates a main storage queue with high priority. 


HIGH=filename 
Specifies a 1- to 7-character name of a disk file for high priority 
messages you created using a DISCFILE macro. 


REMOTE=(node) 
Use this operand only in a computer-to-computer environment that may 
pass through Telcon. It specifies a 1- to 4-character name that identifies the 
remote computer. (This is the same name specified for the REMOTE 
keyword on the LPORT macro.) 


This LOCAP statement must follow the associated VLINE or DCPCHNL 
and LPORT statements. 
Telcon Related Features 


The LOCAP-name must match the name or DESTSSU on a Telcon XEU 
statement, or the name of a LOCAP or application in a remote processor. 
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A.3.6. How to Create Remote Session Entry Tables (LPORT) 


Use the LPORT macro to define and create a table for each DCA logical port. The 
LPORT macro defines a logical path between DCA transport service users. (For 
example, between HOSTA and DCPA, or between HOSTB and HOSTC.) This macro is 
used by the TSTN interface. Each LPORT macro corresponds to an equivalent 
macro/statement in a remote configuration indicated via the PORT number. 


Format 
LABEL AOPERATIONA OPERAND 
not used LINE=name, 
REMOTE=name, 
PORT=nnnn, 


EUt=name 
{,EU2=name) 


,USERTP=| DMI 
Tcl 





STOMCE 





The following details what is required to support a Telcon Network. See 2.16 for 
additional operands and details. 


Operands 


LINE=name 
Is the 1- to 4-character label from the VLINE or DCPCHNL macro. Begin 
the name with an alphabetic character. 


REMOTE=name 
Is the 1- to 4-character name of the destination processor. If a Telcon DCP is 
the destination, this name must match the name on the Telcon DCPTS 
macro. If another processor is the destination, this name must match the 
name on the Telcon DCATS macro for that processor. 


PORT=nnnn 
Is a 4-digit port number in the range of 1 to 4096. This number must match 
the Telcon sch field on the SESSN statement. If another processor is the 
destination, this must match a port number there. 


EU1=name 


Is the label of the TERM, PRCS, or LOCAP macro defining the local end 
user. 
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LPORT 


EU2=name 
Is the label of the TERM or LOCAP macro defining the remote end user 


(computer to computer). Do not supply this name for a program to Telcon 
terminal session. 


USERTP=[ DMI 
TCL 
STOMCE 


Indicates that the session operates through the demand mode interface, 
transaction control interface, or standard interface for DCA global networks. 
ICAM references the user type for outbound session opens and terminal 
spooling. 


PRI=n 
Indicates priority from 1 to 4. The default is 4. The highest priority is 1. 


Telcon Related Features 


Refer to the LPORT macro for descriptions of the REMOTE and PORT keywords. 


Note: Because Telcon maintains a balance of sessions across these logical paths, 
there should be no more than 20 active sessions per LPORT macro. For 
example, if 100 sessions are active between HOSTA and DCPA, at least 5 
LPORT macros should be generated. 
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A.3.7. How to Specify Terminal Characteristics (TERM) 
The TERM macro specifies the characteristics of each remote terminal in your ICAM 
network. Each TERM macro must follow the VLINE or DCPCHNL macro. These 
terminals are physically connected to a Telcon DCP or another processor. 


Format 


LABEL AOPERATIONA OPERAND 





term-name FEATURES=(U2@ |,{ 968 C,SBTIC,CC) |,f PRIMARY 
1929 SECONDARY []) 


(U48 |,f 960 [,CC} |,f PRIMARY 
1926 SECONDARY [1) 


(U100 960 
1024 f 1) 


960 || £,s8T] |,f cP) |t,cc2) 
1024 { PR } | 
1336 
i920 


i 
al Lik 


[,AUX1=(aux-dev- id)[,...,AUX44=(aux-dev-id)]] 





faa on} '{ aa }, | 


(,DVCGID=terminal -group-name] 





= 





aie name [eines 
YES 


continued 
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TERM 


LABEL AOPERATIONA OPERAND 


term-name TERM 
(cont.) 


,LOW=[ filename 
| jain 


{ ate 


; 
er 
me 


{ ,PSEUDO=Tel con- term-name] 
( ,REMOTE=(node-id)] 


»XLATE=({[ ¥ES | ¥ES 
NO NO 
label i, idi labelo,ido } |) 


The following describes what is required to support a Telcon network. See 2.25 for 
additional operands and details. 





Label 


term-name 
Is a 4-character label that identifies the terminal. It must match either the 
term-name in the Telcon generation or local term-name in a remote 
processor. 


Note: If the Telcon term-name is more than four characters, you must use the 
PSEUDO keyword in this macro in order to match terminal names. 


Operands 


FEATURES= 
Identifies the characteristics of this terminal and the features supported, as 
specified in the Telcon generation. See 2.25 for details. 


AUX1=(Caux-dev-id)£,.. ,AUX44=(aux-dev-id)] 
The AUXn operands specify device addresses for auxiliary devices connected 
to this terminal. The AUXn operand must match the Telcon DEVICE macro 
for a terminal. See 2.25 for details. 
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DICE=(f ON ),f N 
OFFf ] FORMS f) 


Describes how you want device independent control expressions (DICE) used 
with this terminal. See 2.25 for details. 





DVCGID=terminal -group-name 
Specifies the name of a remote terminal group in a DCA. The DVCGID 
operand must be one of the following names: 


Interactive Terminals 


INT33 for UNISCOPE 
INT41 for UTS 400 
INT51 for all others 


acai name ][,blanksI[, filename]) 
YES 


Establishes a destination for messages input at this terminal. See 2.25 for 
details. 


LOW, MEDIUM, and HIGH 
Creates low, medium, and high priority terminal output queues in main 
storage or on disk for this terminal. See 2.25 for details. 





PROTYP= { BEV 
INT-1 
Describes how data is presented by the terminal. DEV specfiies device 
dependent for terminals attached to a remote OS/3 host. INT-1 specifies 
interactive terminals attached to a distributed communications processor 
(DCP). 


PSEUDO=Tel con- term-name 
Matches the terminal name specified in a Teleon generation which is greater 
than four characters. Do not use this keyword if four characters or less are 
used; it would only create extra processing. 
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REMOTE=(node- id) 
Specifies the remote processor to which this terminal is connected. Node-id 
is a1- to 4-character name. It must match both the destination node 
specified in the LPORT macro and the Telcon DCPTS macro-name. 


XLATE=(1[ YES .{ YES 
NO NO 
labeli, idi labelo,ido } |) 


The XLATE operand lets you specify the translation table you want to use 
for input from this terminal and also the one you want to use for output 
going to this terminal. See 2.25 for details. 

Telcon Related Features 


Refer to the preceding descriptions for term-name, AUXn, REMOTE, and 
PSEUDO on the ICAM TERM macro. 
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A.3.8. How to Specify Virtual Channels (VLINE) 


Use the VLINE macros to specify the physical link that connects an OS/3 host to a 
Telcon DCP. It isa UDLC connection. 


You must specify all resources that relate to a particular VLINE before you define any 
additional VLINES. 


LABEL AOPERATIONA OPERAND 


1D=stca-number 
, DEVICE=ABM 
{, CHAN=channel -number ] 


= 


ca 
a 
~ 


,TYPE=[ Line-speed } 


symbol 


{ 908 





The following describes what is required to support a Telcon network. See 2.28 for 
additional operands and details. 


Label 


symbol 
Is a 1- to 4-character name of this physical link. It is also referenced by the 
LPORT macro. 


Operands 


1D=slca-number 
For System 80 models 8 - 6, the slca-number is specified as a number 
between 8 and 15 identifying the line number of the single line 
communications adapter (SLCA). For System 80 models 8 - 20, the sica- 
number can be from 1 to 15 for each input/output microprocessor (IOMP). 


DEVICE=ABM 


Specifies this line is used for communications between an OS/3 host and a 
DCP or two OS/3 DCA termination systems. 
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VLINE 


CHAN=channel -number 
Specifies the input/output microprocessor (IOMP) to which the single-line 
communications adapter (SLCA) is connected. See 2.28 for details. 


CMDADDR= { 4 
n 

Is a decimal number between 1 and 255 specifying the universal data link 

control frame level address used to transmit commands and receive 

responses. The default value is 1. 


Note: CMDADDR is required only for DEVICE=ABM. 


“4 value 
Specifies the number of frames (K window value) that can be sent or received 
across this virtual link before an acknowledgment is required. You can 
specify a value of 1 to 7. You must specify K=1 if connected to a DCP or 
passing through a DCP to another OS/3 host. 


RSPADDR= { 3 
n 

Is a decimal number between 1 and 255 specifying the universal data link 

control frame level address used to transmit responses and receive 

commands. The default value is 3. 


Note: RSPADDR is required only for DEVICE=ABM. 











| Line-speed 


Specifies the rate (baud) at which data is transferred between two computers 
described in this macro. Line speed is a function of the modems used. 
Acceptable values are: 2400, 4800, 9600, 19200, 48000, and 56000. The 
maximum for SLCA3 is 9600 baud (full duplex); for SLCA5, the maximum is 
56000 (full duplex). 


Telcon Related Features 
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The CMDADDR operand must match the Telcon /sa field in the STATION 
statement. The RSPADDR operand must match the Telcon rsa field in the 
STATION statement. 
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A.4. TelconACAM Macroinstruction Relationships 


Some labels and parameters of the Telcon configuration statements must be the same 
as those in the ICAM network definition. Table A-2 lists them with the equivalent 
ICAM macro and operand or label. 

Table A-2. Telcon/ICAM Macro Relationships 


Telcon 


CHANNEL 


DCATS 
DCPTS 


Macro Operand or Label 


REMOTE=name* 


LPORT REMOTE=name** 
TERM 


Parameter or Label 


no 
Pad 
o 
7 
Q 
® 
J 
ot 





DEVICE TYPE=dev- type TERM AUXn=(dev- id, did) 
ADR=(dev-adr1, 
dev-adr2) 


| sessn LPORT PORT=por t -number 
STATION VLINE CMDADDR=lsa 
RSPADDR=rsa 


name 
FEATURES=term- type 
PSEUDO=Tel con- term-name 


xeu-name 
DESTSSU 





i Defines name associated with a remote host computer. Use the DCATS name only when connecting an 
OS/3 host to another host (OS/3, UNIX, etc.) through a DCP. 


** Defines name associated with the terminating DCP. 


*** Used only when connecting an OS/3 terminal to a DCP terminal. 
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A.5. A Comparison between Telcon and ICAM 
Terminal Operation 
Terminal operation differs between Telcon and ICAM. The current version of OS 


1100/DCP Series, Communications Delivery Software, Guide to Terminal Operation 
(UP-10041) gives general terminal commands and error messages. 


Note: There are four ways to start a Telcon session, depending on whether your 
interactive terminal is set up for automatic sign-on and session establishment. 
Refer to UP-10041. 


Telcon uses the following format to establish an interactive terminal session: 


SSSON XXxXxx 
_where: 
XXXX 
Is the terminal name. This connects your terminal with the Telcon 
network. 
SSOPEN yyyy 
where: 
Is the application name. This establishes a session with the 
application specified. 
$$CLOSE 


Terminates the session with ICAM. (Telcon resources still exist.) 


$SSOFF 
Terminates the connection with the terminal. Both ICAM and Telcon 
resources are released. 


You don’t need to issue a $$CLOSE command when you want to change sessions. 


Simply key in another $$0PEN command. This closes the current session and 
establishes a new one. 
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ICAM uses the following format: 


S$SON Xxxxyyyy 


where: 
XXXX 
Is the terminal name. 
yyyy 
Is the application name. 
$$SOFF 


Terminates the session and connection to the terminal. 


Examples 


TELCON $$SON TRM4 Connects the terminal to Telcon network 
SSOPEN IMS1 Establishes a session with IMS1 application 
$SCLOSE Terminates session with ICAM 
SSSOFF Terminates terminal connection 
eae OR = so 


S$SON TRM1 Connects the terminal to Telcon network 


$SOPEN IMS1 Establishes a session with IMS1 application 


$SSOPEN IMS2 Closes the IMS1 session, establishes a session 
with IMS2 application 


SSCLOSE Terminates session with ICAM 
SSSOFF Terminates terminal connection 
TRM1IMS1 Establishes a session between the terminal and 
IMS1 application 
SSSOFF : Terminates session 


$$SON TRMTIMS2 Establishes a session between the terminal and 
IMS2 application 


SSSOFF Terminates session 
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A.6. Example Configurations for OS/3 Telcon Networks 
This subsection contains four example network configurations. Each of the first three 
builds upon the preceding example by adding some components and capabilities. All 
examples include: 
¢ Astatement of the example’s purpose 
¢ Descriptions and explanations where necessary 
e A diagram showing the components and their interconnections 
¢ The OS/3 ICAM macroinstructions 


e The Telcon network definition statements 


Each example has only a few points to make. All are kept simple so the points to be 
made are not obscured by a multiplicity of components of the same or similar kinds. 


Both the OS/3 ICAM macros and Telcon network definition statements are listed for 
each example. When they are shown in close proximity in this way, the differences in 
statement syntax or format stand out. 

For the first three examples, one or more network definition statements from the 
previous example are changed in some way. These changes are shaded so you can pick 
them out easily. 


For most network definition statements, you pick your own name or label, according to 
your own naming scheme. 


Note: Only those Telcon statements related to OS/3 ICAM configuration are shown. 
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Example Configuration 1 


Example 1 (Figure A-1) presents a very simple network configuration. There are four 
interactive terminals and one DCP. It is a front-end processor (FEP) connected 
directly to the host computer. 


We don’t show the DCP port identification numbers in the figures. You can find them 
by looking at the ADR values for lines. It is helpful if you give each line a name that 
agrees with the number of the DCP port it connects to. For example, line LBD2D 
connects to port number 2D. 


As you look at the network definition statements for these examples, you will notice 
that the DTP protocol is used where the DMF protocol was used in earlier releases of 
OS/3 ICAM and Telcon. 


The example shows the use of a 6-character Telcon term-name (TERM23) and how the 
ICAM TERM macro for BA0O8 is defined to handle it. 






HOST MODEL 10-20 
(BBL1) 








SLCAS 

UDLC-ABM 

(VLN1, LBD32) 

9600 

DIRECT (L8D2D) 





FEP 
DCP 4@ 
(DBBD) 






PRINTER PRINTER 


Figure A-1. Example Configuration 1 


The components in Example Configuration 1 are: 

¢ The OS/3 host computer 

¢ One DCP 40 Acting as a front-end processor for the host 
¢ Four UTS 20 display terminals (two have printers) 


¢ One 9600 baud direct, half-duplex UNISCOPE line 
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Figure A-2 shows the OS/3 ICAM macros that support Example Configuration 1. 


CARD 


0001 
0002 
0003 


0004 
0005 
0006 


0007 
6008 


0029 


0010 
0011 


0012 
0013 
6014 
0015 
0016 


0017 
0018 
8019 


020 
0021 


0022 
0023 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 


ERROR PHASE 


COMMCT 
BBL1 


STD1 


MAP 1 


DMI1 


TcI1 


VLNi 


DATE 90/03/30 TIME 17:00:35 PAGE 001 


CONFIGURATION PARAMETER OIAGNOSTIC 


CCA 


BUFFERS 


LOCAP 


LOCAP 


LOCAP 


LOCAP 


VLINE 


TYPE=(GBL, ,OS3A) , DCA=YES, 
FEATURES=(OPCOM, OUTDELV) , GAWAKE=YES 


200, 128,5,ARP=150, 

UDUCT=(20, 28,2), 

LINKPAK=(80,280,8) ,RTIMER=10 
TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
TYPE=(DMI) , IAS=(YES, OFF), 

LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

TYPE=(TC1), LOW=MAIN 


DEVICE=(ABM) , TYPE=(56000) ,K=1, 1D=12, 
CMDADDR=3, RSPADDR=1, CHAN=15 


HOST TO TELCON TERMINAL LPORT STATEMENTS 


LPORT 


LPORT 


LINE=VLN1,PORT=55, EU1=DMI 1,USERTP=DMI, 
REMOTE=DBBD 


LINE=VLN1,PORT=56, EU1=STD1,USERTP=STDMCP, 
REMOTE=DBBD 


Figure A-2. OS/3 ICAM Macros for Example Configuration 1 (Part 1 of 2) 


One 56,000 baud direct UDLC line between the host and the front-end processor 
(FEP) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.8 DATE 90/03/38 TIME 17:80:35 PAGE @02 





CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

8024 LPORT LINE=VLN1,PORT=57,EU1=MAP1,USERTP=STDMCP, x 
0025 REMOTE=DBBD 

0026 LPORT LINE=VLN1,PORT=58,EU1=TCI1,USERTP=TCI, X 
0027 REMOTE=DBBD 

0028 BAGS TERM FEATURES=(U2@, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0029 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD) , INPUT=YES, x 
0030 PROTYP=INT- 1 

8031 BA@6 TERM FEATURES=(U2@, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0032 MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) ,, INPUT=YES, x 
6033 PROTYP=INT- 1 

0034 BAQ7 TERM FEATURES=(U20, 1920) , DVCGID=INT33,LOW=MAIN, xX 
0035 MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, x 
0036 PROTYP=INT-1,AUX1=(COP, 73) 

0037 BAGS TERM FEATURES=(U20, 1920) , OVCGID=INT33, LOW=MAIN, xX 
6038 MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, xX 
0039 PROTYP=INT- 1,AUX1=(COP , 73) , PSEUDO=TERM23 

0040 ENDCCA 

6041 = 

0042 MCP MCPNAME=C2 

0043 CACH=( 12,5600, FULL, ILA) , CHAN=15 

0044 END 


Figure A-2. OS/3 ICAM Macros for Example Configuration 1 (Part 2 of 2) 


Figure A-3 shows the Telcon statements that correspond to the OS/3 macros in 
Example Configuration 1. 
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TELVS9*NETWORK( 1) .DEB1(9) 
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HRRKRERERERERERREREERERERRRRERREREEREREEEEEEERERERERERE EERE REEEREREER 


* * 
* PRCSR (PROCESSORS) i 
* * 


MUMIA ARREREREREREEEEEUREEEERERIEE EERE EKERRIEK 


* 

BBD - PRCSR DSPL=ALL, LOGL=ALL ,NMSR='RSC' ,NMSU=('RSC', 144,,10),; 
STATS=(LINE ,3@) 

* 


HAKKAR ERREREKERKERERRREEEEERREREREIUKREREREREEREEEEEEEEREEEKREREEKREEREE 


* * 
* DCPTS (DCP TERMINATION SYSTEMS) * 
* * 


HHEREAKERKEREKERREURERRREREREREEEKEEREEREREREERREREEERKEEEE EERE AERA 


* 


DBBD DCPTS PRCSR=BBD 


* 


RERKKEREIKREREEERKEEREERERIERERREREKKEEREEERKEREREREREEEREEEKEEEREREREREEEER 


* * 
* DCATS (DCA TERMINATION SYSTEMS) = 
* * 


HREREREREREREEERRAEERERRREUREREREKRIEREREREEREREREREEEREEEEREEREEEUREEREREK 


BBL1 DCATS PRCSR=BED *OS3-L1 
HREKKRERERERERREREREEREREREEREREEERREREERERRERERERERREREREREEREREEEEEERERE 
* OS3 SYSTEM L1 XEUS AND SESSIONS 7 
RARERERRERERERERERUERERRRERERERERERERERERERRRERREREREREEEREEKEKEEREEERERERERER 
DMI1 =. XEU TS=BBL1,DESTSSU='DMI1' ,DPP=INT1 

STD = XEU TS=BBL1,DESTSSU='STD1! , DPP=INT1 

MAP1 = XEU TS=BBL1,DESTSSU="MAP1! , DPP=INT1 

Tcl? = XEU TS=BBL1,DESTSSU='TCI1', DPP=INT1 

* 

* 

DMI 1BBL1 SESSN TS1=(DBBD,55, BBD), TS2=(BBL1,55,BBD) 

STD1BBL1 SESSN TS1=(DBBD,56,BBD) , TS2=(BBL1,56, BBD) 

MAP 1BBL1 SESSN TS1=(DBBD,57,BBD) ,TS2=(BBL1,57,BBD) 

TCI 1BBL1 SESSN TS1=(DBBD,58,B8D) , TS2=(BBL1,58, BBD) 
HEKKHKEKAKEKEEKERERERERERERERKREEEERRERERERERKEEKEREKEEREREREEREEREEEEREEKRER 
* CLASS COMMUNICATION LINES/COMMON CHARACTERISTICS * 
* * 


HERRERA EREEREEREERERERREKREKEEEEERERER EEE REEREEEERERREKEREEKEREEEN 


UN96D LCLASS LPH=U10@L , SPEED=9680 , OPTIONS=(DIR,SYHD) 
UDLC568 LCLASS LPH=UDLCL , SPEED=64000 


Figure A-3. Telcon Statements for Example Configuration 1 (Part 1 of 2) 


continued 
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43 RERREKEAEREKEREEEKEERREREERERERERERREEREERREEEREEEREEEEERKREREREREREEREEEK 
44 LBD32 LINE PRCSR=BBD, CLASS=UDLC56@, ADR=X'Q32' * OS3 L1 SYSTEM 
45 

46 RRERKEKRERERERERERREEEREREREREEEEREREREREEEEKRERREREEEREEREREREKREREEEEEEERE 
47 * UDLC STATION BBD TO ALL OS3-NET SYSTEMS a 
48 RARKRREERERERERERREEKEERERERERREERERERERREREERERRERREEEEREKEREREREEKREREEREER 
49 * 

50 STAL1 STATION LINE=LBD32,RSHLE=BBL1,MODE=ABM, LSA=3,RSA=1 * SYS L1 
51 RAREEEKEREREREREREEREEEEEREREREREEREERRERREREREREREREREREEREREEEEEREKREEERE 
52 * MUX LINE DEFINITION STATEMENTS * 
53 REEAEKEHEEREREEREREREERERETEEREREREEERKEEERERERERKEEEEEEREEREEREEREREAEKK KEK 
54 LBD2D LINE PRCSR=BBD, CLASS=UN96D , ADR=02D 

55 RERREREKEREREKEEREREEEERREREREREREERREEREREEEUEEREREEERRERERERERKEEREEEEEEEE 
56 * MUX GROUP DEFINITION STATEMENTS * 
57 REKNEEKEEKEEREREEEREEEEEEERERREREEEEUERREEEEKREEREREEEREKREEEKREKEEGKAKEKAER 
58 GP2D . GROUP PRCSR=BBD, LINE=LBD2D 

59 RERKERHREREKEREKEKERERERREREERREREERERERREEREREEEREREREEREEKKEE KKK KAKI 
62 * TERMINAL STATEMENTS * 
61 RHREKKKEEKEEKKEEREEREERERRERREREREERERERRUEERERERKEEREEREEREREEEEREREEEKEREEEK 
62 BA@S TERM GROUP=GP2D , TYPE=UTS2@ , ADR=(@27, 057) 

63 BAQ6 TERM GROUP=GP2D , TYPE=UTS2@ , ADR=(027 ,058) 

64 BAQ7 TERM GROUP=GP2D, TYPE=UTS2@, ADR=( 27 , 059) 

65 BAQ7P1 —DEVICE TERM=BAQ7,, TYPE=PRTR, ADR=(@, 073) 

66 TERM23 TERM GROUP=GP2D, TYPE=UTS2@, ADR=(@27, @5A) 

67 TERM23P 1 DEVICE TERM=TERM23, TYPE=PRTR, ADR=(@, 073) 





Figure A-3. Telcon Statements for Example Configuration 1 (Part 2 of 2) 
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A.6.2. Example Configuration 2 
Example 2 (Figure A-4) adds another host to the network configuration. This host is a 
UNIX processor configured to run IS5000. Refer to the DIS /5000 User Guide 
(UP-11816) for details on UNIX configuration. 


In the OS/3 ICAM configuration, the LPORT and remote LOCAP macros define the 
UNIX end user. 


In the Telcon configuration, the UNIX processor is set up as another host (DCATS). 














HOST A 
0s/3 
MODEL 10/15/20 
(8BL1) 


SLCA5 
UDLC-ABM 
(VLN1,LBD32) 





FEP 
DCP 46 
(DBBD) 


96@@ DIRECT (LBD2D) 


UDLC-NRM 
(LBD@2) 











PRINTER PRINTER 


HOST B 
UNIX 
5008 
(UXO3) 






Figure A-4. Example Configuration 2 


The components in Example Configuration 2 are: 
¢ ~The OS/3 host computer 


¢ One DCP 40 acting as a front-end processor for the OS/3 host and the UNIX 
1S5000 host 


°¢ The UNIX IS5000 host 
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¢ Four UTS 20 display terminals connected to the DCP 40 (two of the terminals 
have printers) 


¢ One 9600 baud direct, half-duplex UNISCOPE line 


* One 56,000 baud direct UDLC line between the OS/3 host and the front-end 
processor (FEP) 


* One 2400 baud direct UDLC, half-duplex line between the UNIX IS5000 host and 
the FEP 


Figure A-5 shows the OS/3 ICAM macros that support Example Configuration 2. 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 98/03/30 TIME 17:00:35 PAGE 201 








CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

2001 COMMCT 

e002 BBL1 CCA TYPE=(GBL, ,OS3A) ,DCA=YES, X 
0003 FEATURES=(OPCOM, OUTDELV) , GAWAKE=YES 

0004 BUFFERS 200, 128,5,ARP=15, x 
2005 UDUCT=(28,28,2), X 
0006 LINKPAK=(80, 280,8) ,RTIMER=10 

0007 * 

0008 STD1 LOCAP TYPE=(STDMCP) , LOW=MAIN , MEDIUM=MAIN , HIGH=MAIN 

2209 MAP1 LOCAP TYPE=(STDMCP) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

2010 DMI1 LOCAP TYPE=(DMI), IAS=(YES, OFF), x 
0011 LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

0012 * 

0013 Tc11 LOCAP TYPE=(TCI) , LOW=MAIN 

0014 * 

2015 VLN1 VLINE DEVICE=(ABM, DCA2) , TYPE=(56008) ,K=1, 1D=12, x 
0016 CMDADDR=3, RSPADDR=1, CHAN=15 

0017 

0018 

0019 * 

0020 x 
2021 

2022 * 

023 * HOST TO TELCON TERMINAL LPORT STATEMENTS 

0024 * 

0025 LPORT LINE=VLN1,PORT=55,EU1=DMI1,USERTP=DMI, X 
0026 REMOTE=DBBD 

0027 LPORT LINE=VLN1,PORT=56,EU1=STD1,USERTP=STDMCP, x 
0028 REMOTE=D88D 

0029 LPORT LINE=VLN1,PORT=57, EU1=MAP1,USERTP=STDMCP, x 
0030 REMOTE=DBBD 

0031 LPORT LINE=VLN1,PORT=58,EU1=TC11,USERTP=TCI, x 
2032 REMOTE=DBBD 


Figure A-5. OS/3 ICAM Macros for Example Configuration 2 (Part 1 of 2) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.8 DATE 98/83/38 TIME 17:00:35 PAGE 002 








CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

0033 * 

2034 

0035 

2036 

0037 

0038 * REMOTE TELCON TERMINALS 

0039 * 

0040 BAQ5 TERM FEATURES=(U20, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0041 MEDIUM=MAIN , HIGH=MAIN,REMOTE=(DBBD),INPUT=YES, X 
0042 PROTYP=INT- 1 

0043 BAQ6 TERM FEATURES=(U2@, 1920) , DVCGID=INT33, LOW=MAIN, X 
0044 MEDIUM=MAIN,HIGH=MAIN,REMOTE=(DBBD) ,INPUT=YES, —X 
0045 PROTYP=INT-1 

0046 BAQ7 TERM FEATURES=(U20, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0047 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD),INPUT=YES, —X 
0048 PROTYP=INT- 1, AUX1=(COP, 73) 

0049 BAGS TERM FEATURES=(U20, 1920) ,DVCGID=INT33,LOW=MAIN, | X 
ese MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD),INPUT=YES, —X 
0051 PROTYP=INT- 1, AUX1=(COP, 73) , PSEUDO=TERM23 

052 ENDCCA 

0053 * 

0054 MCP MCPNAME=C2 

0055 CACH=(12,56000, FULL, ILA), CHAN=15 

0056 END 


Figure A-5. OS/3 ICAM Macros for Example Configuration 2 (Part 2 of 2) 


Figure A-6 shows the Telcon statements that correspond to the OS/3 macros in 
Example Configuration 2. 
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TELVS9*NETWORK( 1) .DEB1(8) 


1 


COON AUS WP 


= 
= 


HAHAHAHA HITTER ERENT EERE IAT 


* * 
* PRCSR (PROCESSORS) * 
* * 


HR EREREREREEEEERERUEREREEERREREEREREEREREEERREERELII ATA ARTI 


* 

BBD PRCSR DSPL=ALL, LOGL=ALL ,NMSR='RSC' ,NMSU=('RSC', 144, ,10),; 
STATS=(LINE,3@) 

* 


RIKKI AERRERERETERERERREREREERERRERERERARERERARRR ERRATA ARIAT IEEE 


* * 
* DCPTS (DCP TERMINATION SYSTEMS) * 
* * 


FOI III III IIIT III II IO III IIIA IA IAIN AIAN AON ITS ASN SAAN ISAM 
* 

DBBD DCPTS PRCSR=BBD 

* 


REREREREREREREREEREEREEEEERREREREREERERERKEREREEREEEREEREUKEERRERERKEEAEIN 


* * 
* DCATS (DCA TERMINATION SYSTEMS) ¥ 
* * 


RARRAERERERERERERERERERRERERUEREUEEERERREER RENEE TREE 





BBL1 DCATS PRCSR=BBD *OS3-L1 

Ht) (0) SS UNIX 

RIAA ERURE EERE RERRREREREREERMEUEEERAIRERUEREREREREI AAAI IAAI 
* OS3 SYSTEM L1 XEUS AND SESSIONS * 
KRRKEKKEEEEEEEEREKEEEREREERERERREEEEREKREREREREEKEEREREEREEERERKARERAERRREREEN 
OMI1 XEU TS=BBL1, DESTSSU="DMI1° ,DPP=INT1 

STD1 XEU TS=BBL1,DESTSSU='STD1' ,DPP=INT1 

MAP 1 XEU TS=BBL1, DESTSSU='"MAP1' , DPP=INT1 

Tc11 XEU TS=BBL1, DESTSSU="TCI1', DPP=INT1 

* 

* 

OMI 18BL1 SESSN TS1=(DBBD,55,BBD) , TS2=(BBL1,55,BBD) 

STD1BBL1 SESSN TS1=(DBBD,56,BBD) , TS2=(BBL1,56, BBD) 

MAP 1BBL1 SESSN TS1=(DBBD,57,BBD) , TS2=(BBL1,57, BBD) 

TCI 1BBL1 SESSN TS1=(DBBD,58,BBD) , TS2=(BBL1,58, BBD) 

* 


RKRKRKKEREEREREEERERRERERRREREREREEEEEE EKER REESE ERE 






HK KAIRIE EERE REET EERE MEE ERITREA 





Figure A-6. Telcon Statements for Example Configuration 2 (Part 1 of 2) 
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HK RREKERREUREEERERERRREEERERERREEREREEEERRERUEEEREREEREREEREREREEREEEN 


7 CLASS COMMUNICATION LINES/COMMON CHARACTERISTICS * 
* * 


FEISS ISI NOI IIIT IIIT IIIT IIIT I IAI I 
LCLASS LPH=U1@OL , SPEED=9600 , OPTIONS=(DIR, SYHD) 


Be 


LPH=UDLCL , SPEED=64000 






UDLC568 LCLASS 


HAHA SEERERRERUREERREURREREREEERRERUR TRENT EEEERITARTATETN 








LBD32 LINE PRCSR=BBD, CLASS=UDLC56@, ADR=X'@32' * OS3 L1 SYSTEM 
t NIX92) ADREX1O2)" © UNIX SYSTEM 





REUKRIRENARERREREEERRERERREEREREREEREEREEREEEEREREREEEREREENEEEREREREEEEETEE 


= UDLC STATION BBD TO ALL OS3-NET SYSTEMS m 


HRRKREREEERARREREERREREEREREEERERRERERREEREREREREREEERERAREEEEKERREERERAEEE 


* 





4 TW;REAZOBA 


HHH IIR IHRE III CREE IRE AIAREERIREEERERTREEERREMEREEREREAII 


* MUX LINE DEFINITION STATEMENTS * 
HHH EAI RRER ARERR RERERIRERE EERE EEE IAT EIT EET 
LBD2D LINE PRCSR=BBD , CLASS=UN96D, ADR=02D 

RAKE EREREREEEEEREREEEEEEEEEREEREREEEEEEREEREEEEEEEREEEEEREEEEE 
* "MUX GROUP DEFINITION STATEMENTS 7 
HAKKAR EEE EERERREERUREEREREEEEEERER EERE EERE EREEEEN 
GP2D  —- GROUP PRCSR=BBD, LINE=LBD2D 
HAAR RERERERURERUREAEREREEEREERENERREEEERERREEEEEREENAEEK KK I 
* TERMINAL STATEMENTS * 
RRRERKERERKEREEKEEREREEREREEEREREREREREREEEREEREEREREREEEEKEEEEEKIERERERERE 
BAQS TERM GROUP=GP2D , TYPE=UTS2@, ADR=(027, 057) 

BAQ6 TERM GROUP=GP2D , TYPE=UTS20, ADR=( 027, 058) 

BAG7 TERM GROUP=GP2D , TYPE=UTS2@, ADR=( 027, 059) 

BAQ7P1 —DEVICE TERM=BAQ7, TYPE=PRTR, ADR=(0, 073) 

TERM23 TERM GROUP=GP2D, TYPE=UTS2@, ADR=( 027, @5A) 

TERM23P1 DEVICE TERM=TERM23, TYPE=PRTR, ADR=(0, 073) 


Figure A-6. Telcon Statements for Example Configuration 2 (Part 2 of 2) 
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UNIX Configuration 


The following are the UNIX parameters required for Host B to support Example 
Configuration 2. 


Local UNIX Parameters 
SDLC address: 8A 
Matches RSA= on Telcon STATION statement named STAUNIX. 
OWN HOST ID: UNXH 
Matches ICAM remote LOCAP name in BBL1 CCA. 
Remote Host ID/Logical Channel Definitions 
DMI1/75 
DMI1 matches ICAM local LOCAP name in BBL1 CCA; 75 matches TS1 Isch 
on Telcon SESSN statement UNX1BBL1. If DDP is not used within the 
DCP, there is no requirement for the DCATS name (UXO3) in TS1 to be the 
same as the DDP host ID (UNXH). 


Refer to the DIS /5000 User Guide (UP-11816) for details on UNIX - Telcon host 
configuration. 
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A.6.3. Example Configuration 3 


Example Configuration 3 (Figure A-7) adds an OS/3 host (Host C) with its own 
communications lines and terminals. The terminals connected to Host C are defined 
as local to Host C and are included in this example to illustrate order of macro 
presentation in the ICAM generation. There is no intent here to have these terminals 
be in session with another host. 


Host C is connected to the DCP40 (FEP A) via an SU0039 CHANNEL. The terminals 
connected to the DCP40 can be in session with Host A and/or Host C. 


Example Configuration 3 shows the relationships between the OS/3 ICAM LPORT 
and remote LOCAP macros, the UNIX parameters, and the Telcon SESSN statements 
for host to host and host to Telcon terminal connections through the DCP. 


9608 DIRECT RWS (LNE4) HOST C 
0s/3 


MODEL 10/15/20 LWS 


UTS UTS UTS UTS (BBQ@6) LWS (LC12) 
20 20 20 20 (LC18) 
S$U8039 UTS 
CHANNEL UTS . 20D 
(CHN1, CHBBQ6) 40D 


9608 DIRECT UNISCOPE (LBD2D) 








FEP A 
DCP48 
SLCA5 20 20 20 20 
UDLC- ABM 
(VLN1, LBD32) 
_ HOST A (.BD02) 


0S/3 
HOST B 


MODEL 10/15/20 
(BBL 1) UNIX 


(UX03) 





Figure A-7. Example Configuration 3 


The components for Example Configuration 3 are: 
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Two OS/3 host computers (Hosts A and C) 
The UNIX IS5000 host (Host B) 


One DCP40 acting as a front-end processor for both OS/3 hosts and the UNIX 
1S5000 host 


One SU0039 channel between OS/3 Host C and the FEP 


One 56,000 baud direct UDLC line between OS/3 Host A and the front-end 
processor (FEP) 


One 2400 baud direct UDLC half-duplex line between Host B (the UNIX IS5000) 
and the FEP 


One 9600 baud direct half-duplex UNISCOPE line connected to DCP40 
Four display terminals connected to DCP40, some with printers 

One 9600 baud direct RWS line connected to OS/3 Host C 

Four UTS 20 terminals, two with printers attached to OS/3 Host C RWS line 


Two LWSs connected to OS/3 Host C 


Figure A-8 shows the OS/3 ICAM macros for Host C used in Example Configuration 3. 


CARD 


8201 
0002 
0003 
0004 
8005 
0006 
0007 
8008 


0009 


UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.6 DATE 90/03/38 TIME 17:00:35 PAGE 001 


ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

COMMCT 

BBQ6 CCA TYPE=(GBL, ,OS3A) ,DCA=YES, x 
FEATURES=(OPCOM, OUTDELV) , GAWAKE=YES , DCPLOAD=YES 

BUFFERS 208, 128,5,ARP=150, X 

UDUCT=(100,28,2), X 
LINKPAK=(80, 28,8) , RTIMER=10 

CUP 1 LOCAP TYPE=(STDMCP), LOW=MAIN,MEDIUM=MAIN,HIGH=MAIN 

STDA LOCAP TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

STDB LOCAP TYPE=(STDMCP) , LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 


Figure A-8. OS/3 ICAM Macros for Host C in Example Configuration 3 (Part 1 of 4) 
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A-44 


eee 


UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.8 DATE 90/03/30 TIME 17:00:35 PAGE 002 


CARD — ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 
0210 NOD2 LOCAP TYPE=(DMI), IAS=(YES,OFF) ,MODE=SYSTEM, X 
0011 LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

0012 IMS1 LOCAP TYPE=(TCI),LOW=MAIN 

0013 IMS2 LOCAP TYPE=(TCI), LOW=MAIN 

0014 LNES LINE DEVICE=(RWS), x 
0015 TYPE=(962@,SYNC), Xx 
0016 1D=08, CHAN=15 ,RETRY=(6,6) , INPUT=(YES) 

0017 PGROUP PGID=27 

0018 DLG1 TERM ADDR=(27,57) , FEATURES=(U20,,,, PRIMARY), Xx 
0019 LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

0020 DLG2 TERM ADDR=(27,58) , FEATURES=(U2@,,, , SECONDARY), Xx 
0021 LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 

0022 SIL1 TERM = ADDR=(27,59) , FEATURES=(U20,,, ,PRIMARY) ,AUX1=(COP,73),  X 
0023 LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

e024 S1L2 TERM = ADDR=(27, 5A) , FEATURES=(U2@, ,,, SECONDARY) , AUX1=(COP,73), X 
0025 LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

0026 Lc12 LINE DEVICE=(LWS), LBL=1024 

0027 we12 TERM ADDR=(C12) , FEATURES=(U20), x 
0028 LOW=MAIN,MEDIUM=MAIN , HIGH=MAIN 

0029 Lc18 LINE DEVICE=(LWS),LBL=1024 

0030 wc18 TERM ADDR=(C18) , FEATURES=(U4@), x 
0031 LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

0032 PRC1 PRCS LOW=MAIN 

0033 PRC2 PRCS LOW=MAIN 


eee 


Figure A-8. OS/3 ICAM Macros for Host C in Example Configuration 3 (Part 2 of 4) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 90/03/30 TIME 17:00:35 PAGE 803 


CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

0034 PRC3 PRCS LOW=MAIN 

0035 PRCS PRCS LOW=MAIN 

0036 SESSION EU1=(PRC1) ,EU2=(IMS1) 

0037 SESSION EU1=(PRC2) , EU2=(1MS1) 

0038 SESSION EU1=(PRC3) , EU2=( IMS2) 

6039 SESSION EU1=(PRC4) , EU2=( IMS2) 

0040 CHN1 DCPCHNL CNID=7,1D=12,REMOTE=DBBD 

0041 * 

0042 = HOST TO HOST LPORT STATEMENTS 

0043 - 

0044 LPORT LINE=CHN1,PORT=64, EU1=NOD2, EU2=UNXH ,USERTP=DMI, xX 
6045 REMOTE=UX03 

0046 LPORT LINE=CHN1,PORT=81,E€U1=NOD2,EU2=DMI 1,USERTP=DMI, x 
0847 REMOTE=BBL 1 

0048 

0049 = HOST TO TELCON TERMINAL LPORT STATEMENTS 

0050 

0051 LPORT LINE=CHN1,PORT=63,EU1=NOD2,USERTP=DMI, xX 
0052 REMOTE=DBBD 

0053 LPORT LINE=CHN1,PORT=60,EU1=CUP1,USERTP=STDMCP, xX 
054 REMOTE=DBBD 

0055 LPORT LINE=CHN1,PORT=61,EU1=STDA,USERTP=STDMCP, x 
0056 REMOTE=DBBD 

0057 LPORT LINE=CHN1,PORT=62,EU1=STDB,USERTP=STDMCP, xX 
0058 REMOTE=DB8D 

0059 LPORT LINE=CHN1,PORT=65 ,EU1=1MS1,USERTP=TCI, x 
6060 REMOTE=DBBD 





Figure A-8. OS/3 ICAM Macros for Host C in Example Configuration 3 (Part 3 of 4) 
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ng a 
UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 90/23/30 TIME 17:00:35 PAGE 004 





CARD ERROR _—~wPHASE CONFIGURATION PARAMETER DIAGNOSTIC 
0061 LPORT LINE=CHN1,PORT=66,EU1=IMS2,USERTP=TCI, X 
0262 REMOTE=DBBD 

0063 * 

0064 * REMOTE LOCAPS 

0065 * 

0066 UNXH LOCAP TYPE=(DMI) , LOW=MAIN, MEDIUM=MAIN, REMOTE=(UX03) 

0067 DMI1 LOCAP TYPE=(DMI) , LOW=MAIN, MEDIUM=MAIN, REMOTE=(BBL1) 

0068 * 

0069 * REMOTE TELCON TERMINALS 

2070 * 

0071 BAGS TERM FEATURES=(U20, 192@) ,DVCGID=INT33, LOW=MAIN, x 
0072 MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD), INPUT=YES, X 
0073 PROTYP=INT- 1 

0074 BAQ6 TERM FEATURES=(U2@, 1928) ,DVCGID=INT33, LOW=MAIN, x 
0075 MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, x 
0076 PROTYPSINT- 4 

077 BAQ7 TERM FEATURES=(U2@, 1920) ,DVCGID=INT33, LOW=MAIN, . Xx 
0078 MEDIUM=MAIN , HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, X 
0079 PROTYP=INT- 1, AUX1=(COP,73) 

080 BAQS TERM FEATURES=(U2Q, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0081 MEDIUM=MAIN , HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, 

0082 PROTYP=INT- 1, AUX1=(COP, 73) , PSEUDO=TERM23 

0083 ENDCCA 

0084 MCP MCPNAME=C3 

6085 CACH=( 13, BB@6, 1) 

0086 CACH=(08, BBQ6, 2) 

0087 CACH=(12, ,DCPCHNL) , CHAN=7 

0088 END 


eee 


Figure A-8. OS/3 ICAM Macros for Host C in Example Configuration 3 (Part 4 of 4) 


Figure A-9 shows the OS/3 ICAM macros for Host A in Example Configuration 3. 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 90/03/38 TIME 17:00:35 PAGE 001 





CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 
0001 COMMCT 

e202 BBL1 CCA TYPE=(GBL, ,OS3A) ,DCA=YES, 4 
0003 FEATURES=(OPCOM, OUTDELV) , GAWAKE=YES 

0004 BUFFERS 200, 128,5,ARP=15@, x 
0005 UDUCT=(20, 28,2), Xx 
0006 LINKPAK=(8@, 280, 8) ,RTIMER=10 

0007 * 

0208 STD1 LOCAP TYPE=(STDMCP) , LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 

0009 MAP 1 LOCAP TYPE=(STDMCP) , LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 

0010 DMI1 LOCAP TYPE=(DMI), IAS=(YES,OFF), X 
0011 LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 

0012 * 

0013 Tcl4 LOCAP TYPE=(TCI),LOW=MAIN 

0014 * 

0015 VLN1 VLINE DEVICE=ABM, TYPE=(5600@) ,K=1, ID=12, x 
0016 CMDADDR=3, RSPADDR=1, CHAN=15 

0017 * 

0018 * HOST TO HOST LPORT STATEMENTS 

0019 * 

0020 LPORT LINE=VLN1, PORT=59, EU1=DMI 1, EU2=UNXH, X 
0021 USERTP=DMI , REMOTE=UX03 

0022 X 
0023 

0024 

0025 * HOST TO TELCON TERMINAL LPORT STATEMENTS 

0026 * 

0027 LPORT LINE=VLN1,PORT=55,EU1=DMI 1,USERTP=DMI, X 
0028 REMOTE=DBBD 

0029 LPORT LINE=VLN1,PORT=56,EU1=STD1,USERTP=STDMCP, X 
0030 REMOTE=DBBD 

0031 LPORT LINE=VLN1,PORT=57,EU1=MAP1,USERTP=STDMCP, X 
@032 REMOTE=DBBD 





Figure A-9. OS/3 ICAM Macros for Host A in Example Configuration 3 (Part 1 of 2) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 90/03/30 TIME 17:00:35 PAGE 002 








CARD ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

0033 LPORT LINE=VLN1,PORT#=58,EU121C11,USERTP=TCI, x 
0034 REMOTE=DBBD 

0035 * 

0036 * REMOTE LOCAPS 

0037 * 

0038 UNXH LOCAP TYPE=(DMI), LOWSMAIN,MEDIUM=MAIN, HIGH=MAIN, X 
2039 REMOTE=(UX03) 

0040 ii x 
0041 

0042 * 

0043 * REMOTE TELCON TERMINALS 

0044 * 

0045 BAGS TERM FEATURES=(U20, 192@) , DVCGID=INT33, LOW=MAIN, X 
0046 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD), INPUT=YES, 
0047 PROTYP=INT- 1 

2048 BAQ6 TERM FEATURES=(U2@, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0049 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD),INPUT=YES, —X 
9050 PROTYP=INT-1 

0051 BAQ7 TERM FEATURES=(U20, 1920) ,DVCGID=INT33, LOW=MAIN, x 
0052 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD),INPUT=YES, —X 
0053 PROTYP=INT- 1, AUX1=(COP, 73) 

0054 BAOS TERM FEATURES=(U20, 1920) , DVCGID=INT33, LOW=MAIN, x 
0055 MEDIUM=MAIN, HIGH=MAIN,REMOTE=(DBBD), INPUT=YES,  X 
0056 PROTYP=INT- 1, AUX1=(COP, 73) , PSEUDO=TERM23 

0057 ENDCCA 

0058 * 

2059 MCP MCPNAME=C2 

060 CACH=(12,56@00, FULL, ILA), CHAN=15 

0061 END 





Figure A-9. OS/3 ICAM Macros for Host A in Example Configuration 3 (Part 2 of 2) 
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UNIX Configuration (Host B) 


The following are the UNIX parameters required for Host B to support Example 
Configuration 3. 


Local UNIX Parameters 
SDLC address: 8A 
Matches RSA= on Telcon STATION statement named STAUNIX. 
OWN HOST ID: UNXH 
Matches ICAM remote LOCAP name in BBL1 and BB06 CCA. 
Remote Host ID/Logical Channel Definitions 
DMI1/75 


DMI1 matches ICAM local LOCAP name in BBL1 CCA; 75 matches TS1 [sch 
on Telcon SESSN statement UNXIBBL1. 


NOD2/76 


NOD2 matches ICAM local LOCAP name in BB06 CCA; 76 matches TS1 
Isch on Teleon SESSN statement UNX1BB06. 


Note: If DDP is not used within the DCP, there is no requirement for the 
DCATS name (UXO3) in TS1 to be the same as the DDP host ID (UNXF). 


Refer to the DIS /5000 User Guide (UP-11816) for details on UNIX - Telcon host 
configuration. 


Figure A-10 shows the Telcon statements that correspond to the OS/3 macros for 
Hosts A and C and the UNIX parameters for Host B in Example Configuration 3. 
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TELVS9*NETWORK( 1) .DEB1(@) 
ITEtt ti ittittriiett trite rt iti ttre iter et titre r ert ier er ert Toe Pro 


* * 
* PRCSR (PROCESSORS) * 
* * 


REKKKKCAREEREEEKEREREEEEERREEEEREREREEEEERERREREREREREEEEKUUEREREEEREEEKEE 


* 

BBD PRCSR DSPL=ALL, LOGL=ALL , NMSR='RSC' ,NMSU=('RSC', 144,,18),; 
STATS=(LINE ,3@) 

* 


HKARKKEAEREEREKEEEEERREREREREKREREREEEREREEEEEREREREEERERERERERREEEEEEEEE 


* * 
* DCPTS (DCP TERMINATION SYSTEMS) 7 
* * 


HREKKKHREEEEERRERREERERAKEREEREEEREEEEEERERERERREREKEEREEEEEEKEEREEEKREREREEK 


* 


DBBD OCPTS PRCSR=BBD 


* 


HAKKAR EREREREREKREERETEREKEEERRERUEREREEREKEEKEKEREREEREEEEEEEN 


* * 
* DCATS (DCA TERMINATION SYSTEMS) * 
* * 


nN a2 2 = @ = 2 2 = = = 
BP Ovovanauvwrwn SWAN A UVM AFWN = 





22 MIKKKEAREREREKEKRRREREEEREEREEEREREREEEREEUEEEREREEEKEAEKEKAKEKKKRAK KKK 
23 BB@6.. DCAT: RCSR=BB S3-M1 

24 BBL1 DCATS PRCSR=BBD *0S3-L1 

25 UXO3 DCATS PRCSR=BBD  *OS3-UNIX : 

26 HUKKEEKREKREREEEEEEKUEREREERERRERERERERERERERERERERERUEKERERERAEEEKAA KAKI 
27 bas OS3 SYSTEM L1 (BBL1) XEUS AND SESSIONS * 
28 MAKER REEEREREEEREERERERREEEEREEEREEEEEEREEERERIEEEERERE 
29 DMI1 XEU TS=BBL1,DESTSSU='DMI 1", DPP=INT1 

30 ST01 XEU TS=BBL1,DESTSSU='STD1" ,DPP=INT1 

31 MAP 1 XEU TS=BBL1,DESTSSU='MAP1' , DPP=INT1 

32 Tc! XEU TS=BBL1,DESTSSU='TCI1',DPP=INT1 

33 * 

34 * 

35 DMI 18BL1 SESSN TS1=(DBBD,55,B8BD) , TS2=(BBL1,55, BBD) 

36 STD1BBL1 SESSN TS1=(DBBD,56,B8D) , TS2=(BBL1,56, BBD) 

37 MAP 1BBL1 SESSN TS1=(DBBD,57,BBD) , TS2=(BBL1,57,BBD) 

38 TCI 1BBL1 SESSN TS1=(DBBD,58, BBD), TS2=(8BL1,58, BBD) 

39 KEKE IEEE EEK EERE EKER EERIE IKEA EER 
40 * OS3 SYSTEM M1 (BB@6) XEUS AND SESSIONS * 
41 We He Ke KKH HH HHH IK IIHT KEITH HERRERA TREAT ARR IK I II 
42 

43 

44 

45 








Figure A-10. Telcon Statements for Example Configuration 3 (Part 1 of 3) 
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46 
47 
48 
49 
5@ 
51 
52 
53 
54 
55 
56 
57 
58 
59 
62 


61. 


62 
63 


65 
66 
67 
68 
69 
78 
71 
72 
73 
74 
75 
76 
77 
78 
79 
88 
81 
82 
83 
84 
85 
86 
87 








TMS¢BBO Esa B BD) , TS2=(BBO6 


RURKIREIKRERREREREREREEREEEREREEEREREREREREEEREEREREREERERERREREREEERER 


bl HOST TO HOST SESSIONS = 
FAIR III IIIA III SORIA IIASA AINSI NIA TIN II NON ARI I 







UNX1BBL 1 SESSN 


WRK ERERERERERRERREEUEREREEEREERREEEEEEREREEEEEEERERERREEEEEEK 


* CLASS COMMUNICATION LINES/COMMON CHARACTERISTICS iad 
* * 


REREKREKKEEREREREREEEEEERREREEEEEREREREEEREEEREREREEEREREEEEEREREREEREEREER 


UN96D LCLASS LPH=U19@L , SPEED=9600 , OPTIONS=(DIR,SYHD) 

UNIX92 LCLASS LPH=UDLCL , SPEED=2400, OPTIONS=(DIR,SYHD) 
UDLC56@ LCLASS LPH=UDLCL , SPEED=64000 

FOI III IIIA IIIA TTT IITA AAI IAIIRIIT ISIS AAI IAAI ATI NAIR INS OTIS ISSIR III 
LBD32 LINE PRCSR=BBD, CLASS=UDLC560, ADR=X'@32' * OS3 L1 SYSTEM 


LBDe2 LINE PRCSR=BBD, CLASS=UNIX92,ADR=X'@2' * UNIX SYSTEM 





MITT IER TIM HII ANAT IR RIERA IA IRR IREIII ARIAT ITIT IANA IIIA IANIA ITN 
* UDLC STATION BBD TO ALL OS3-NET SYSTEMS = 
ICRI TORII TC TIT RTA T RTI RTI TI ITAA AT ATI TAA TAA AIO TNA AI ASAI AAS IAAI IANA. 


* 


STAL1 STATION LINE=LBD32, RSHLE=BBL1,MODE=ABM, LSA=3,RSA=1 * SYS L1 
STAUNIX STATION LINE=LBD@2, RSHLE=UXO3 , MODE=NRM, LSTYP=PRIM, RSA=O8A 


HUH HRA AEEHEEERERERREEREEREREREREEEREEREEREREEREREEEEEEEEEEREEEEEEEEN 


* MUX LINE DEFINITION STATEMENTS * 
HHH H IAAI ITAA EEE EERE IEREREEREERERREREREREERE 
LBD2D LINE PRCSR=BBD,, CLASS=UN96D , ADR=@2D 

FRI I I IRIRIIIIIOO IIIT IOI ISI IIIS SAI INS ASSN IA IIIS SSAA SSI INSIS AI IIA AA 
* MUX GROUP DEFINITION STATEMENTS * 
FESR IRI III IIIT II TTI I IAAI IIASA III IAI III IIIS AI III IS 
GP2D GROUP PRCSR=BBD ,LINE=LBD2D 





UP-9745 Rev. 3 


Figure A-10. Telcon Statements for Example Configuration 3 (Part 2 of 3) 


A51 





Example Configurations 








88 RRRIKIAARRIAIRTR RTI ARIA I AAAI TAA TIAA ATI TTA ARITA AAT III ATA IAAT IIS NII ISIN 
89 i TERMINAL STATEMENTS * 
90 SII IIA IAI TIA AAI IARI IAI IIIA IITA III IAI AAAI III INARI AIO IN AISI IAI 
91 BAGS TERM GROUP=GP2D ,, TYPE=UTS2@, ADR=( 27, 057) 

92 BA@6 TERM GROUP=GP2D , TYPE=UTS2@, ADR=( 27, 058) 

93 BAQ7 TERM GROUP=GP2D , TYPE=UTS2@, ADR=(027, 059) 

TA BAQ7P 1 DEVICE TERM=BAQ7 , TYPE=PRTR, ADR=(0, 073) 

95 TERM23 TERM GROUP=GP2D,, TYPE=UTS20, ADR=(827 , @5A) 

96 TERM23P1 DEVICE TERM=TERM23, TYPE=PRTR, ADR=(0, 873) 


Figure A-10. Telcon Statements for Example Configuration 3 (Part 3 of 3) 


Example Configuration 4 


Example Configuration 4 (Figure A-11) presents a small configuration of a UDLC and 
SU0039 CHANNEL connection between the OS/3 host and a DCP15. The DCP15 is 
connected to a DCP40 via a UDLC trunk. 


Terminals connected to the DCP15 and DCP40 can access the OS/3 host across the 

VLINE or CHANNEL, depending on the $$OPEN name used. This is accomplished 

by using two Telcon DCATS statements (BM10, B10). The XEU, SESSN, STATION, 

and CHANNEL statements refer back to the DCATS statements. An outbound OPEN e 
from OS/3 host to a Telecon terminal uses whichever connection (VLINE or 

CHANNEL) the terminal is defined from in the ICAM generation. 





This configuration also shows how a dual-screen Telcon terminal (BA07, BAO8) is 
defined in the OS/3 ICAM generation to support OS/3 terminal spooling. Nothing is 
required in the Telcon generation. If multiple paths (VLN1, CHN1) are used between 
System 80 and DCP, the path that the terminal is defined off of (CHN1) must be 
initialized for the terminal spooling commands to execute normally. 


Another terminal (BE10, BE11) is defined in the Telcon generation to automatically 
sign on and open the initial session to the OS/3 DMI LOCAP (DMI8) across the 
CHANNEL as a result of first input at the terminal. This is accomplished by using 
the Telcon TERM statement with ALOC=YES and DEST=DMI8CH specified. (This is 
only done for the initial OPEN. Any operator $$OPEN overrides the defined 
destination.) Nothing is required in the ICAM generation. 


This configuration illustrates the relationship between the TS1 and TS2 /sch numbers 
on the Telcon SESSN statements and the port numbers on the ICAM LPORT macros. 


¢ From the Telcon DCP15 generation: 
DMIB108 SESSN TS1=(DBBE, 1,BBE) ,TS2=(B10,1,BBE) 


OMI8BM1@  SESSN TS1=(DBBD,73, BBD) , TS2=(BM10,7, BBE) 
STD8BM1@  SESSN TS1=(DBBD, 74, BBD) , TS2=(BM18,8, BBE) 
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¢ From the ICAM generation: 


LPORT LINE=VLN1,PORT=1,EU1=DM18,USERTP=DM! , REMOTE=DBBE 
LPORT LINE=CHN1, PORT=7,EU1=DMI8,USERTP=DMI , REMOTE=DBBD 
LPORT LINE=CHN1, PORT=8,EU1=STD8,USERTP=STDMCP , REMOTE=DBBD 


The ICAM port number matches the Telcon lsch number on the TS1 or TS2 parameter 
that refers back to the OS/3 host via the DCATS name specified as the termination 
system. In this example, it matches with TS2. The TS1 parameter defines the other 
termination system that TS2 will be in session with. In this example, it is a DCPTS 
defined as DBBE or DBBD and associated with a DCP processor (BBE or BBD) to 
which the terminals are connected. B10 or BM10 are the DCATS names that 
reference the OS/3 host. BBE is the DCP processor with which this OS/3 host is 
associated. The TS1 and TS2 sch numbers have no meaning to each other within a 
SESSN statement. The numbers represent a logical relationship between the 
termination system and the associated processor within TS1 or TS2 (DBBE and BBE, 
B10 and BBE, DBBD and BBD, BM10 and BBE). 












OS/3 HOST A 
(BM18, B10) 


SLCA3 
UDLC-ABM 
(VLN1,LBEQ4) 


SUG039 CHANNEL 
(CHN1, CHBM12) 





FEP 
bcP15 
(DBBE) 


UNISCOPE (LBE@1) 


UTS 28 
(BE16) 





UDLC- TRUNK 
(LBE@6, LBD2F ) 









RC 
DCP4@ 
(DBBD) 


UNISCOPE (LBD20) 





PRINTER 
BA@7P 1 


Figure A-11. Example Configuration 4 


PRINTER 
BA@S8P 1 
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The components in Example Configuration 4 are: 

¢ The OS/3 host computer 

¢ One DCP15 acting as a front-end processor for the OS/3 host 
¢ One DCP40 acting as a remote concentrator 


¢ One dual-screen UTS 20 display terminal connected to DCP15 via a 9600-baud, 
direct, half-duplex UNISCOPE line 


¢ Two dual-screen UTS 20 display terminals (one with printer) connected to DCP40 
via a 9600-baud, direct, half-duplex UNISCOPE line 


¢ One 9600-baud, direct UDLC line between host and DCP15 
¢ One SU0039 CHANNEL between host and DCP15 
¢ One 56,000-baud, direct UDLC line between DCP15 and DCP40 


Figure A-12 shows the OS/3 ICAM macros that support Example Configuration 4. 
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ERROR 


UP-9745 Rev. 3 


UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 98/03/30 TIME 09:52:31 PAGE 001 

PHASE CONFIGURATION PARAMETER DIAGNOSTIC 

COMMCT 

DcPI CCA TYPE=(GBL,,BM10) ,DCA=YES, X 
FEATURES=(OPCOM, RESTART ,OQUTDELV, SEGMENTS ,MONI TOR), x 


+ &* ££ * + +  # HF HF F 


” 
o 
iw] 
a 


MAPS 


DMI8 


Tc1s 


VLN1 


CCAID=BM10, GAWAKE=YES , SAVE=YES , OCPLOAD=YES 


BUFFERS 25,8000,5,ARP=150, 
UDUCT=(20, 28,2), 
LINKPAK=(25, 1064, 2) ,RTIMER=15 


$SOPEN NAMES ACROSS CHANNEL: DMI8CH 
STD8CH 
MAP8&CH 
TCI8CH 


SSOPEN NAMES ACROSS UDLC: DMI8UD 
STD8UD 
MAP8UD 
TCI8UD 


DMI8 
STD8 
MAPB 
TC18 


DMI8 
STD8 
MAP8 
Tc18s 


LOCAP TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN ,HIGH=MAIN 


LOCAP TYPE=(STDMCP) , LOW=MAIN,MEDIUM=MAIN,HIGH=MAIN 


LOCAP TYPE=(DMI), 1AS=(YES,OFF), 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 


LOCAP TYPE=(TCI),LOW=MAIN 


VLINE DEVICE=(ABM, DCA2) , TYPE=(9600) ,K=1,1D=05, 


CMDADDR=3 , RSPADDR=1, CHAN=15 


HOST TO TELCON TERMINAL (DBBD) LPORT STATEMENTS ACROSS UDLC 


LPORT LINE=VLN1,PORT=11,EU1=DMI8,USERTP=DMI, 


REMOTE - DBBD 


LPORT LINE=VLN1,PORT=12,EU1=STD8,USERTP=STDMCP, 


REMOTE=DBBD 


Figure A-12. OS/3 ICAM Macros for Example Configuration 4 (Part 1 of 3) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.0 DATE 98/03/38 TIME 09:52:31 PAGE @02 


ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 


LPORT LINE=VLN1,PORT=13,EU1=MAP8,USERTP=STDMCP, 
REMOTE=DBBD 


LPORT LINE=VLN1,PORT=14,EU1=TCI8,USERTP=TCI, 
REMOTE=DBBD 


HOST TO TELCON TERMINAL (DBBE) LPORT STATEMENTS ACROSS UDLC 


LPORT LINE=VLN1,PORT=1,EU1=DM18,USERTP=DMI, 
REMOTE=DBBE 


LPORT LINE=VLN1,PORT-2,EU1=STD8,USERTP-=STDMCP, 
REMOTE=DBBE 


LPORT LINE=VLN1, PORT=3,EU1=TC18,USERTP=TCI, 
REMOTE=DBBE 


CHN1 DCPCHNL CNID=7, 1D=12,REMOTE=DBBE 
* HOST TO TELCON TERMINAL (DBBD) LPORT ACROSS DCP CHANNEL 


LPORT LINE=CHN1,PORT=7,EU1=DMI8,USERTP-DMI, 
REMOTE =DBBD 


LPORT LINE=CHN1,PORT=8,EU1=STD8,USERTP-STDMCP, 
REMOTE=DBBD 


LPORT LINE=CHN1,PORT=9,EU1=MAP8,USERTP-STDMCP, 
REMOTE=DBBD 


LPORT LINE=CHN1,PORT=18,EU1=TC18,USERTP=TCI, 
REMOTE=DBBD 


HOST TO TELCON TERMINAL (DBBE) LPORT ACROSS DCP CHANNEL 


LPORT LINE=CHN1,PORT=4,EU1=DMI8,USERTP=DMI, 
REMOTE=DBBE 


LPORT LINE=CHN1,PORT=5,EU1=STD8,USERTP-STDMCP, 
REMOTE=DBBE 


Figure A-12. OS/3 ICAM Macros for Example Configuration 4 (Part 2 of 3) 
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UNISYS OS/3 SYSTEM GENERATION PARAMETER PROCESSOR 


RELEASE VERSION 13.0.8 DATE 90/83/36 TIME 09:52:31 PAGE @03 
ERROR PHASE CONFIGURATION PARAMETER DIAGNOSTIC 
LPORT LINE=CHN1,PORT=6,EU1=TC18,USERTP=TCI, x 


REMOTE=DBBE 


* REMOTE TELCON TERMINALS CONNECTED TO DCP40 - BBD 

* 

BA@S TERM FEATURES=(U20, 1928) , DVCGID=INT33, LOW=MAIN, xX 
MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, xX 


PROTYP=INT-1 


BAQ6 TERM FEATURES=(U2@, 1928) ,DVCGID=INT33, LOW=MAIN, Xx 
MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, xX 
PROTYP=INT- 1 


BAG7 TERM FEATURES=(u2@, 1928, , ,PRIMARY) ,DVCGID=INT33, LOW=MAIN, 
MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD), INPUT=YES, xX 
PROTYP=INT=I , AUX1=(COP, 73) 


=< 


BAQS TERM FEATURES=(U2@, 1920, , ,SECONDARY) ,DVCGID=INT33, LOW=MAIN, 
MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBD) , INPUT=YES, x 
PROTYP=INT- 1, AUX1=(COP, 73) 


bad 


* REMOTE TELCON TERMINALS CONNECTED TO DCP15 = BBE 
BE10 TERM FEATURES=(U20, 1928) , DVCGID=INT33, LOW=MAIN, xX 
MEDIUM=MAIN, HIGH=MAIN, REMOTE=(DBBE), INPUT=YES, Xx 


PROTYP=INT-1 
BE11 TERM FEATURES=(U2@, 1928), DVCGID=INT33, LOW=MAIN, X 
MEDIUM=MAIN , HIGH=MAIN , REMOTE=(DBBE) , INPUT=YES, x 
PROTYP=INT-1 
ENDCCA 
MCP MCPNAME=M5 
CACH=(@5, 9600, FULL, ILA), CHAN=15 


CACH=(12, ,DCPCHNL) , CHAN=7 


END 


Figure A-12. OS/3 ICAM Macros for Example Configuration 4 (Part 3 of 3) 
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Figure A-13 shows the DCP15 (DBBE) Telcon statements that correspond to the OS/3 
ICAM macros and DCP40 (DBBD) Telcon statements in Example Configuration 4. 


BBD PRCSR * 4-04 BLUE BELL 
DSPL=ALL, LOGL=ALL,NMSR='RSC! , TIMEQUT=(60,60),; 
STATS=(LINE, 30) , CPUSTATS=YES, PPESTATS=YES 

BBE PRCSR; * 5-@5 BLUE BELL 
DSPL=ALL, LOGL=ALL ,NMSR='RSC' , TIMEQUT=(60,60),; 
STATS=(LINE, 3) ,CPUSTATS=YES, PPESTATS=YES 


HRKEKEKREKKEREKEREERREREREEREREERERREREREEREERREREREREREREREEEEEEEEEEEEKE 


* DCPTS (DCP TERMINATION SYSTEMS) * 
HAA IKRIR IRR RIAA IRR ERAN AIA IANA INIA AAI III IN AAI IAI AI ISNA 
DBBD DCPTS PRCSR=BBD 

DBBE DCPTS PRCSR=BBE 

FOR IORI IR IIIT IRI IIIT AAAI ASIANA AAAI AAAI AIA DASA ANIA IIAS AIS IAN 
* DCATS (DCP TERMINATION SYSTEMS) * 
AIHA IR IRI IR IR MIRAI ARIE RANA AARNE INITIATE IAEA AIRE RR I 
BM10 DCATS PRCSR=BBE * MOD8-OS/3 DEVELOPMENT M10 

B10 DCATS PRCSR=BBE * MOD8-OS/3 DEVELOPMENT M10 

IRI I RAIA II IIA IAAI IASI AAAS AAAI IAAI IAI AISI IAAI AAI SAINI IAI IIASA 
ba LOCAL XEU'S ACROSS CHANNEL = 


HKKEKEKKEEREEKEREKEEEREREREREEEEREEREREREREREEREEREEREREREREREEEREEEEEEEKE 


DMI8CH XEU TS=BM18,0PP=INT1,DESTSSU='DMI8! 
STD8CH XEU TS=BM10,DPP=INT1,DESTSSU='STD8' 
MAP8CH XEU TS=BM1,DPP,INT1,DESTSSU='MAP8! 
TCI8CH XEU TS=BM10,DPP,INT1,DESTSSU='TCI8! 


HIKERKRIKREEEEIREEREKREEEEEEKEEREREREEKRKRERREREREREEEREKEEREREEEEREREREREKE 


* LOCAL XEU'S ACROSS UDLC * 
RUKKEEKKEKEREREERERERELEREREREKREREREEREEEREREEREREKEEERREEREREREREREEK 
DMI8UD XEU TS=B10,DPP=INT1,DESTSSU='DMI8! 
STD8UD XEU TS=B10,DPP=INT1,DESTSSU='STD8! 
MAP8UD XEU TS=B1@,DPP, INT1,DESTSSU="MAP8! 
TCI8UD XEU TS=B10,DPP,INT1,DESTSSU='TCI8! 


REREKEREREREREREREREREERERERURKEEEREREEREREEREREREEERERREREEERERRERERERERE 


* SESSIONS FROM BBE ACROSS CHANNEL * 
REREEKEERKEEEKAAEEREREREEERREREEREREEREREREEEREEEEEEEREEEREREREREEREEREEEER 
DMIBM1@  SESSN TS1=(DBBE,4,BBE) , TS2=(BM10,4,BBE) 
STDBM1@ SESSN TS1=(OBBE,5, BBE) , TS2=(BM10,5, BBE) 





TCIBM10 SESSN TS1=(DBBE ,6, BBE) , TS2=(BM18,6, BBE) 

FR III I TOR IIIT IIIA IIIA ITA IIASA IA ISI I IRINA AAI AIAN AAAI AMAIA AAAI IIIA AI 
* SESSIONS FROM BBE ACROSS UDLC >: 
FRR IAI III RIT IIIT I IOAN AISA SAIS AANA AISI NAS AI SOAN IS AISI NASA IAI IS IAIAI 
DMIB1@ SESSN TS1=(DBBE,1,BBE),TS2=(818,1,BBE) 

STDB18 SESSN TS1=(OBBE,2,BBE) ,TS2=(810,2,BBE) 

TCIB10 SESSN TS1=(DBBE ,3,BBE), 1S2=(818,3, BBE) 





Figure A-13. DCP15 Telcon Statements for Example Configuration 4 (Part 1 of 2) 
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Figure A-13. DCP15 Telcon Statements for Example Configuration 4 (Part 2 of 2) 
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RERKREREREEREREEARUEEREREREEERERERRERERRUEEREEREEEEREEREEREEREREEEREREREEE 


* SESSIONS FROM BBD ACROSS CHANNEL * 
REKKEEREEREEEREREREEEERERERERUERRERREEREEREREEEREREREREREREEREERERERERREE 
DMI8BM1@  SESSN  —«- TS 1=(DBBD, 73, BBD) , TS2=(BM10,7, BBE) 

STD8BM1@ SESSN  —- TS1=(DBBD,74,BBD) , TS2=(BM1@,8, BBE) 

MAP8BM10 SESSN —- TS 1=(DBBD, 75, BBD) , TS2=(BM10, 9, BBE) 

TC18BM1@  SESSN  —»s-TS4=(DBBD,76,BBD) , TS2=(BM1@, 10, BBE) 


RERERREEREREREREERERERREEERREEEREREREREEEREREREREEREREREEEREEEEEEEREREEE 


* ‘ SESSIONS FROM BBD ACROSS UDLC * 
REKEREKRKKKEEEEEEKEEEREERERREEEREERRRERERERREREEREEEREEREREREEREREEREKEK 
DMI8B10 SESSN TS1=(DBBD,40,BBD) ,TS2=(B10, 11, BBE) 
STD8B10 SESSN TS1=(DBBD,41,BBD) , TS2=(B1@, 12, BBE) 
MAP8B10 — SESSN TS1=(DBBD, 42, BBD) ,TS2=(B10, 13, BBE) 
TC18B1@  SESSN TS1=(DBBD, 43, BBD), TS2=(B10, 14, BBE) 


REERKERAREEEEEEKEEREREREEREREREREERREEREREEERREEREREEEEEEREEREEERERERKEEIAE 


* LCLASS STATEMENTS * 
HREKKEKKCKEREEEEEREEEREREREREEEEREREREREREREREEREERERERERERERERERERERES 
UDL96FDX LCLASS LPH=UDLCL , SPEED=9600, OPTIONS=(DIR, SYFD) 

UDLC56@ LCLASS LPH=UDLCL , SPEED=64000 

UN96D —LCLASS_ LPH=U10@L , SPEED=9600 


REKKKRERREREREEEREREERREEEREREREREEREREEEEREEEREREREREREREEEEREEREREERERER 


, LINE STATEMENTS * 
RRERERERERERERRRERERERERREEERERRERERRERERERERREEREREEEEREERERUEREREREREEE 
LBE@1 LINE PRCSR=BBE , CLASS=UN96D, ADR=X'Q1' TERMINAL USE 

LBEQ4 LINE PRCSR=BBE , CLASS=UDL96FDX, ADR=X'@4' * TO BM10 

LBE@6 LINE TRUNK=TBBEBBD, CLASS=UDLC56@,ADR=X'@6' * TO BBD 2F 


CHBM1@ CHANNEL TS=BM1@,PPID=X'@D! , WINDOW=1 


REAKEUKKRIEKHEHRNEHURERERRUERUERERRRERERREUERRERRUEEEERRERERRERRREREERERREI 


* STATION STATEMENTS * 
REKKEKEKREEKEREEEEEEREREREEEREEERERERREUEEEREREEEEREREREREREERERERERERER 
STBEQ4 § STATION LINE=LBEQ4,RSHLE=B10,MODE=ABM, LSA=3,RSA=1 

SBBEBBD STATION LINE=LBEQ6,RSHLE=TBBEBBD 


HARKEKKAEKEREKREREEREREEREREREREREEEEREREEEREREREREREREREREREREREREEERREERE 


= GROUP STATEMENTS = 
FAIRIES AIRTIME IAAI ASAI 


GP@1 GROUP PRCSR=BBE, LINE=LBE@1 
FRI IIIA IO TITIAN AIAN AAAI RNIN INIA IOAN IAS ASIANS AI 


* LINE LBEQ1 ‘i 


RENKKEEKKEKEREKEREREEEREEEREEEERERRRERREEERREEEREERERUERRERREKREREEREREREEEE 


BE10 TERM GROUP=GP01, TYPE=UTS2@, ADR=(@21, 051), ALOC=YES, DEST=DMI8CH 


BE1@PR DEVICE TERM=BE1@, TYPE=PRTR,ADR=(0,073) 
BE11 TERM DUALSCRN=BE 10 
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Figure A-14 shows the DCP40 (DBBD) Telcon statements that correspond to the OS/3 
ICAM macros and the DCP15 (DBBE) Telcon statements in Example Configuration 4. 


BBD PRCSR * 4-04 BLUE BELL 
DSPL=ALL, LOGL=ALL ,NMSR='RSC! , TIMEQUT=(60,68),; 
STATS=(LINE, 30) , CPUSTATS=YES , PPESTATS=YES 

BBE PRCSR ss; * 5-05 BLUE BELL 


DSPL=ALL, LOGL=ALL , NMSR='RSC' ,, TIMEOUT=(68,68),; 


STATS=(LINE, 38) , CPUSTATS=YES , PPESTATS=YES 
PRK IIR IRI III RIT II ATI IAI III AAAI AI IASI IN AAI IASI AIAN ISS IAAI IAA ARIA AAAI 


* DCPTS (DCP TERMINATION SYSTEMS) * 
FESO OOS IIIT III III III IIIA TOISAS ORION OI 
DBBD DCPTS PRCSR=BBD 

DBBE OCPTS PRCSR=BBE 

HII RIAA IAAI SIRI AAAI ARIAS RIIRIEIAIIN IIIA SAINI IAI ASIAN IAIAINIAIRIAN 
* DCATS (DCP TERMINATION SYSTEMS) * 
HARIRI IIR I IAI IAI IAI IIIA AAI IAAI ARIANA A TINA ANAT IAIN IAIN AT INDIANA 
BM18 OCATS PRCSR=BBE * MOD8-OS/3 DEVELOPMENT M10 

B10 DCATS PRCSR=BBE * MOD8-OS/3 DEVELOPMENT M1@ 
HHHRRIRR AIRE RAI IIR III IIIT ISI IIASA IIASA NASA AIS AITASIA NIA IISA IN AIAINAIIA 
* LOCAL XEUS FOR BM1@ ACROSS CHANNEL bal 


HHKKRKKRMREURERENERERRRERIEREEEERRERERRERERREREEREEREREREREKERERERREREREE 


DMI8CH XEU TS=BM1@,DESTSSU='DMI8! , DPP=INT1 
STD8CH XEU TS=BM1@,DESTSSU='STD8' ,DPP=INT 1 
MAP8CH XEU TS=BM1@,DESTSSU='MAP8! ,DPP=INT1 
TCI8CH XEU TS=BM1@,DESTSSU='TCI8' ,DPP-INT1 


RIKI IKEERRUREEREREREREREEREEREREREKKKKKAKA KKK 


* LOCAL XEUS FOR B1@ ACROSS UDLC * 
HHMI REEREEREERREEUEREEERERERREREERREEREEEERREEREREEEKKEE 
DMI8UD XEU TS=B1@,DESTSSU='DMI8' ,DPP=INT1 
STD8UD XEU TS=B10,DESTSSU='STD8' ,DPP=INT1 
MAP8UD XEU TS=B10,DESTSSU="MAP8! , DDP=INT1 
TCI8UD XEU TS=B10,DESTSSU="TCI8" ,DPP-INT1 


HARKER EREREEEKKEIEREEEEREREREERERREEEREEREREEEEEEEEREREREEREEEREREREREREK 


* SESSIONS FROM BBD ACROSS CHANNEL * 
RREKERKEERERREREEEKEREEERREREREEERERREEREERERERERREEEREEEREEREEEEREKEKKE 
DMI8BM10 — SESSN TS1=(DBBD, 73, BBD) , TS2=(BM10,7, BBE) 

STO8BM1@  SESSN TS1=(DBBD, 74, BBD) , TS2=(BM10,8, BBE) 

MAP&BM1@  SESSN TS1=(DB8D,75,88D) ,TS2=(BM 19,9, BBE) 

TCI8BM10  SESSN TS1=(DBBD, 76, BBD), TS2=(BM10, 10, BBE) 


REEKRAKKKKEEKEEEEKEKEKERREREREEEKERERRERERREREREEEEEKRKEKKKKKKERKKKKKRKEKK 


* SESSIONS FROM BBD ACROSS UDLC * 
HHH I HIRI HIRE ERR EERIE EET RIEREEIRIR IIR EREIA ARRIETA 
DMI8B1@  SESSN TS1=(DBBD, 40, BBD) , TS2=(B1, 11, BBE) 
STD8B1@  SESSN TS1=(DBBD,41,BBD) , TS2=(B10, 12, BBE) 
MAP8B1@ —- SESSN TS1=(DBBD,42,BBD) , TS2=(B10, 13, BBE) 
TC18B1@  SESSN TS1=(DBBD, 43, BBD) , TS2=(B10, 14, BBE) 











Figure A-14. DCP40 Telcon Statements for Example Configuration 4 (Part 1 of 2) 
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RERRHRERREKERERURERERERERERRERERREREREREERERERERERERERRREREREEEREREEKE 


* CLASS OF COMMUNICATION LINES/COMMON CHARACTERISTICS * 
HRKKAERARKRRARARRKRERRRERERTREEEN REE hhh hhh 
UNS6D —_LCLASS._ LPH=U1@@L, SPEED=9600, OPTIONS=(DIR, SYHD) 

UDDLC5S6® LCLASS LPH=UDLCL, SPEED=64000 


RREREEREREEREEREEEREREEEREEREREEREREERREREREEEEREREREEREREREREEEEREEREREE 


* UDLC LINES FROM 88D TO BBE * 
REREKREAIRIRER ARERR IRR RERE HIATT IA IAI IIIA III IOS NII ASIA ONIN ISNA 


LBD2F LINE TRUNK=TBBDBBE, CLASS=UDLC568,ADR=X'2F* * ADR=X'@6! DCP15 
RRAKHIRRR ARRIETA AKIRA IAAI INIA IIASA IAS IAIIAIAI ISAAC 


* UDLC STATION 8BD TO BBE * 
HHRKERRR IHRE AIR AIR IIR ARR ERER NAIA RERIAR AAI ARIAT I 


STBBOBBE STATION LINE=LBD2F,RSHLE=TBBDBBE * BBDBBE 
RHKRRARRARRRERRERERRARERRERREAARERERERERERREERERREIAREAR ERT RIAARRERN 


7 MUX LINE, GROUP, AND TERM DEFINITION STATEMENTS - 


RERREEKKEREREKEERERERERRERREEEREREREREERREEREERREEEEREURERKREERKEEEEERREEE 


LBD2D LINE PRCSR=BBD,CLASS=UN96D ,, ADR=02D 
* 


GP2D GROUP PRCSR=BBD, LINE=LBD2D 

* 

BAQS TERM GROUP=GP2D, TYPE=UTS2@, ADR=(027, 057) 
BAQ6 TERM GROUP=GP2D, TYPE=UTS2@, ADR=(027, 058) 
BAQ7 TERM GROUP=GP2D, TYPE=UTS20, ADR=( 027,059) 
BAQ7P1 DEVICE TERM=BAQ7, TYPE=PRTR, ADR=(@, 073) 
BAGS TERM GROUP=GP2D, TYPE=UTS2@, ADR=(027, @5A) 
BAQ8P1 DEVICE TERM=BAQ8, TYPE=PRTR, ADR=(0, 073) 


‘Figure A-14, DCP40 Telcon Statements for Example Configuration 4 (Part 2 of 2) 
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A.7.1. 





General Comments 


OS/3 ICAM Static Sessions 


ICAM global DCA networks require dynamic sessions. These sessions can be made to 
seem static for users accustomed to having ICAM static sessions by defining the 
terminals in the Telcon configuration as auto-allocated and specifying the destination. 
Refer to the Telcon TERM statement (ALOC and DEST parameters) in the current 
version of the OS 1100/DCP Series, Communications Delivery Software, 
Configuration Guide (UP-9957). This configuration permits the initial session to be 
established without the operator having to sign on or $$OPEN. 


VLINEs 


If the VLINE connecting the OS/3 host to the DCP goes down, it must be brought back 
up manually. 


If the VLINE link is not established at initialization time, check to see if CMDADDR 
and RSPADDR match with Telecon LSA and RSA on the STATION macro. 





Multiple Paths between System 80 and DCP 


Multiple paths (two UDLC links, etc.) can be configured between a System 80 and a 
DCP. 


Depending on the $$OPEN used at the Telcon terminal, a session is made across the 
desired path. The System 80 does not care which VLINE or DCPCHNL defines the 
remote terminal. 


If a session is to be made from a System 80 to a Telcon terminal (outbound open), the 
VLINE or DCPCHNL to which the remote terminal is defined will be the path used. 
There is no choice. 


OS/3 Terminal Spooling 


If multiple paths are used between System 80 and DCP, the VLINE or DCPCHNL to 
which the remote terminal is defined must be active and up. If not initialized, the 
result of the terminal spooling command will be an error message displayed on 
screenl (RP03 AUX DEVICE NOT AVAILABLE). 
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Additional Documentation 


A8. Additional Documentation 


You will need additional manuals to configure Telcon and ICAM networks. The 
following are some of these manuals; you can order them through your representative. 
They also contain references to other related documents. 


UP-9745 Rev. 3 


OS 1100/DCP Series, Communications Delivery Software, Configuration Guide 
(UP-9957) 


Tells how to install a communication network and configure it for your particular 
network. 


OS 1100/DCP Series, Communications Delivery Software, Installation Guide 
(UP-9956) 


Tells how to install, generate, and verify CMS 1100 and Telcon. Pairs with the 
Configuration Guide to provide complete information for configuring/installing a 
communication network in CMS 1100/Telcon. 


OS 1100/DCP Series, Communications Delivery Software, Software Release 
Description (UP-10726) 


Accompanies the CMS 1100 and Telcon tape shipped to customers. Describes all 
improvements and changes since the previous release of CMS 1100 and Telcon. 
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Appendix B 


Configuring UTS 20/30/40/400 and 
SVT 1120/1123/1124 Terminals 


The following examples illustrate how to use the U400..., U20..., and U40... 
suboperands of the TERM macroinstruction. The material in this appendix 
supplements the information presented in 2.25 for the TERM macro. 


The UTS 20 and UTS 40 terminals have a dual screen capability and may be 
configured as standard terminals or as remote workstations. 


B.1. Terminal Configurations 


Specify DEVICE=(UNISCOPE) in the LINE macro for the communication line that 
supports the terminal. 


¢ The following shows how to specify a UTS 400 terminal with screen bypass 
feature for a communications output printer (COP). The COP printer is 
physically connected to the controller but can be accessed either through the UTS 
400 (TRM1) or directly as a screen bypass terminal (TRM2). The COP printer is 
physically connected to the controller. 


LOGICAL 
UTS 400 
AUX CONNECTION 
CONTROLLER TO COP 






UTS 400 (TRM1) 





bee 
_—— 
SBT » 
TRM1 TERM FEATURES=(U400, 1920) ,ADDR=(28,51) , AUX1=(COP,73), x 
LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 
TRM2 TERM FEATURES=(U40Q, ,SBT) ,ADDR=(28,52) , AUX1=(COP, 73) x 


LOW=MAIN ,MEDIUM=MAIN, HIGH=MAIN 
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¢ UTS 20 single station with terminal printer (TP) auxiliary Device: 





UTS 20 (TRM3) 


TRM3 TERM FEATURES=(U20, 1920) ,ADDR=(21,51) ,AUX1=(TP,73), X 
LOW=MAIN 


e = The following shows two UTS 20W workstations and an 8406 diskette subsystem 
attached to a cluster controller. Also, a communications output printer (COP) 
and a terminal printer (TP) are connected to the terminals. A screen bypass 
feature is installed in terminal TRM5. 


The TRM4 definition specifies there is a COP printer attached to the terminal 
with a device identifier (did) of 73. 





The TRM5B definition specifies the TP is accessed as AUX1. A diskette subsystem 
has two drives. Each disk drive requires two dids, one for reading and one for 
writing, in this case identified as sids 75, 76, 77, 78. A program accesses each 
drive function as an auxiliary device, e.g., AUX2, AUX3, AUX4, and AUX5 
respectively. Access to the diskette is through the TRM5 display screen. 


CLUSTER 
CONTROLLER 










UTS 20W (TRMS5) 





8406 DISKETTE 
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TRM4 TERM FEATURES=(U2@, 1920, ,CC)ADDR=(29,51), x 
AUX 1=(COP, 73) , LOW=MAIN, MEDIUM=MAIN 

TRMS TERM FEATURES=(U2@, 1920, SBT, CC) ,ADDR=(29,52), x 
AUX 1=(TP, 73) , AUX2(TCS, 75, 76) ,AUXS=(TCS, 77, 78), X 


LOW=MAIN,MEDIUM=MAIN 


e¢ The following shows a UTS 20 single station equipped with a screen bypass 
feature. This feature allows your program to write to the terminal printer (TP) or 
to the communications output printer via TRM7 while the terminal operator 
concurrently uses the display screen to enter and receive data. Your program 
communicates with the screen via TRM6. 





UTS 20 SINGLE STATION 
EQUIPPED WITH 


SCREEN BYPASS 
(TRM6,TRM7) 


TRM6 TERM FEATURES=(U20, 1920, ) ,ADDR=(30@,51), LOW=MAIN 
TRM7 TERM FEATURES=(U2@, 1920,SBT) ,ADDR=(30,52), x 
AUX 1=(TP, 73) , AUX2=(COP, 74), LOW=MAIN 
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¢ This example shows how to define a UTS 40 single station terminal with a 
terminal printer: 





UTS 40 (TRM9) 


TRM9 TERM FEATURES=(U4@, 1920) ,AUX1=(TP,73), X 
LOW=MAIN,MEOIUM=MAIN,HIGH=MAIN 


¢ This example shows how to define a UTS 40 single station terminal with a dual 
screen and terminal printer: 


LINE 






N\ Ss 


UTS 40 WITH 2 
INTERNAL SCREENS 
(TRMA), (TRMB) 


Notice that two TERM macros are required, one for each display screen. 


TRMA TERM FEATURES=(U46, 1920) ,ADDR=(31,51), x 
AUX1=( TP, 73) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
TRMB TERM FEATURES=(U40, 1928) , ADDR=(31,52), xX 


AUX1=(TP, 73), LOW=MAIN,MEDIUM=MAIN, HIGH=MAIN 
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The following example shows two UTS 40W workstations and an 8406 diskette 
subsystem attached to a cluster controller. Each UTS 40W has a dual screen 
capability, and each display screen is defined as a separate terminal. This 
arrangement lets your program communicate with each screen and to any 
auxiliary devices related to them. The COP printer and the TP printer are 
physically connected to the terminals, while the diskette is physically connected 
to the cluster controller. Notice that the TRM5 and TRM6 definitions allow your 
program to communicate with the same 8406 diskette subsystem (one for each of 
the cassettes in the dual cassette subsystem), as well as the terminal printer. 






CLUSTER 
CONTROLLER 


8406 DISKETTE 


TRM3 TERM FEATURES=(U4@, 192@,CC) ,ADDR=(29,51) ,AUX1=(COP,73), x 
LOW=MAIN 

TRM4 TERM FEATURES=(U4@, 1920, CC) , ADDR=(29,52) , AUX1=(COP,73), X 
LOW=MAIN 

TRMS TERM FEATURES=(U4Q, 1920, CC) ,ADDR=(29,53) ,AUX1=(TP,73), X 
AUX2=(TCS 75,76) ,AUX4=(TCS, 77,78) , LOW=MAIN 

TRM6 TERM FEATURES=(U4@, 1920, CC) ,ADDR=(29,54) ,AUX1=(TP,73), X 


AUX2=(TCS 75,76) ,AUX4=(TCS, 77,78) , LOW=MAIN 
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¢ The following example illustrates how to attach remote printers to a cluster 
controller without dedicating a workstation to the print operation. In order to do 
this, the UTS 4000 remote print utility is required. The utility is described in the 
UTS 4020/4040 System Utilities User Guide (UP-8218). 


The equipment shown consists of one UTS 20W workstation, one UTS 40W 
workstation, one 8406 diskette subsystem, and a remote printer attached to a 
cluster controller. 


The remote printer utility can create up to nine remote printer interfaces in a 
cluster controller, and each one you create must be identified by the host with a 
station identifier (sid). (In our example, we defined only one remote printer 
interface.) Data is routed through a remote printer interface to a printer as 
though it were a screen bypass feature. 


CLUSTER 
CONTROLLER 









UTS 40W (TRM5, TRM6) 
WITH TWO SCREENS 


8406 DISKETTE 


TP (TRM7) 


TRM4 TERM FEATURES=(U2@, 1920, CC) ,ADDR=(29,51) , AUX1=(1P, 73), X 
LOW=MAIN 

TRMS TERM FEATURES=(U4Q, 1920,CC) ,ADDR=(29, 52), LOW=MAIN 

TRM6 TERM FEATURES=(U40, 1920,CC) ,ADDR=(29,53) ,AUX1=(TP, 73) x 
AUX2=(TCS,75, 76) , AUX4=(77, 78) , LOW=MAIN 

TRM7 TERM FEATURES=(U20, 1920, SBT, CC) , ADDR=(29,54) ,AUX1=(TP,73), x 
LOW=MAIN 
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Configuring UTS and SVT Terminals 


The definition makes it possible to: 


Communicate (send/receive) with the screen of TRM4, or send a message to 
the terminal printer attached to TRM4 by specifying the auxiliary device 
(AUX1) in your program 


Communicate with the screen of the UTS 40W defined as TRM5. TRM5 and 
TRM6 define different screens on the same terminal. Note that TRM5 has 
no AUX parameter specified. 


Communicate with the alternate screen of the UTS 40W defined as TRM6, 
write to the terminal printer defined as AUX1, or access a disk drive function 
(read or write function) by specifying AUX2, AUX3, AUX4, or AUX5 


Print a message on the terminal printer by sending it to TRM7, AUX1. 


ICAM treats the remote printer interface as a screen bypass feature with a 
station identifer of 54. 
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B.2. Local Workstation Configurations 
Specify DEVICE=(LWS) in the LINE macro for the workstation address. 


¢ UTS 20D local workstation (Model D: 





TRM1 TERM FEATURES=(U2Q) ,ADDR=(312) , INPUT=YES, HIGH=MAIN 


¢ UTS 40D local workstation (Model II) with auxiliary printer: 






AUXILIARY PRINTER (PRNTR) 


TRM2 TERM FEATURES=(U4@) , ADDR=(312) , AUX1=(PRNTR), INPUT=YES, HIGH=MAIN 


¢ SVT 1122 local workstation with auxiliary printer: 


TRM3 TERM FEATURES=( 1122), ADDR=(C13), AUX1=(PRNTR), INPUT=YES, LOW=MAIN 
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B.3. Remote Workstation Configurations 
For all remote workstation configurations, you must specify the following: 
- DCA=YES in the CCA macro 
- UDUCT and LINKPAK parameters on the BUFFERS macro 


-  DEVICE=(RWS) in the LINE macro for the communication line that supports the 
terminal 


- |_MODE=SYSTEM on the LOCAP specified as TYPE=DMI 


- APGROUP macro for each RWS polling group 


¢ UTS 20 remote workstation with single screen storage: 





UTS 20 (WSI) 


PGROUP PGID=32 
WS1 TERM FEATURES=(U2@, 1928) ,ADDR=(32,51), x 
AUX 1=( TP, 73) , LOW=MAIN 


¢ UTS 20 remote workstation with dual screen storage: 





UTS 20 WITH 2 
INTERNAL SCREENS 
(WS2), (WS3) 


PGROUP PGID=33 

WS2 TERM FEATURES=(U29, 1920,,,PRIMARY),ADDR=(33,51), xX 
AUX1=(TP, 73), LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 

WS3. TERM FEATURES=(U20, 1920, , SECONDARY) , ADDR=(33 ,52), x 
AUX1=(TP, 73) , LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
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¢ UTS 40 remote workstation with dual screen storage: 


LINE sees 





UTS 40 WITH 2 
INTERNAL SCREENS 
(WSS), (WS6) 


PGROUP PGID=35 


WS5 TERM FEATURES=(U4@, 1920, , PRIMARY) , ADDR=(35,51), X 
AUX1=(TP, 73) , LOW=MAIN , MEDIUM=MAIN, HIGH=MAIN 
WS6 TERM FEATURES=(U4Q, 192@, , SECONDARY) , ADDR=(35,52), X 


AUX 1=(TP, 73), LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
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Appendix C 
CU/DEV Addresses 


Table C-1 lists the valid CU/DEV addresses with their EBCDIC I/O characters and 
hexadecimal values. These addresses are used on the TERM macro for specifying 
IBM 3270 emulated terminals (see the ADDR= operand of the TERM macro in 
Section 2). 


Table C-1. CU/DEV Addresses 


CU or Device EBCDIC EBCDIC 
Number /O Character Hex Value 
0 SP 40 
1 A Cl 
2 B C2 
3 Cc C3 
4 D C4 
5 E c5 
6 F C6 
7 G C7 
8 H C8 
9 I co 
10 [ 4A 
ll ; 48 
12 < 4c 
13 ( 4D 
14 + 4E 
15 ! 4F 
16 & 50 
17 J Dl 
18 K D2 
19 L D3 
20 M D4 
2l N D5 
22 0 D6 
23 P D7 
24 Q D8 
25 R D9 
26 ] 5A 
27 $ 5B 
28 7 5C 
29 ) 5D 
30 ; 5E 
31 Sora oF 
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Index 


A 


ABBADDR operand, RDTE macro, 2-101 
Activity request packet pools 
maintaining statistics, 2-20 
specifying, 2-3, 2-7, A-10 
statistics area format, (figure) 4-18 
statistics area sample, (figure) 4-19 
statistics areas, 2-11, 4-17, A-11 
Telcon network, A-9 
ADDR operand, TERM macro, 2-134 
ADDRESS operand 
LDTE macro, 2-51 
RDTE macro, 2-103 
STATION macro, 2-110 
ALTD operand, TERM macro, 2-137 
Alternate process file, defining label, 2-137 
ANSWER operand, TERM macro, 2-138 
ARP operand, BUFFERS macro, 2-7, A-10 
ASCII code, LINE macro, 2-57 
Automatic dialing, lines, 2-62, 2-65 
Automatic line buffering routines, CCA 
macro, 2-19 
Automatic line turnaround, 2-76 
Auxiliary devices 
addresses, 2-138 
defining, Telcon network definition, A-3 
disk-queued TCI network, (figure) 3-19 
standard interface dedicated network, 
3-16 
standard interface dedicated network 
with none, (figure) 3-12 
AUXI operand, TERM macro, 2-138, A-21 
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Batch terminals, input record size, 2-146 
Binary synchronous communications 
LINE macro, 2-57 
TERM macro, 2-123 
BSC operand 
LINE macro, 2-57 
TERM macro, 2-123 
BUFF operand, JRNFILE macro, 2-49 
Buffer pools 
expansion factor, 2-8, A-10 
length, 2-5 
maintaining statistics, 2-20 
number, 2-5 
physical link, 2-165 
specifying, 2-3 
statistics areas, 2-11, 4-17 
Telcon network, A-9 
Buffer statistic records, 4-8 
Buffers 
link, 2-9, A-10 
network, specifying, 2-3 
pools (See Buffer pools.) 
(See also Network buffers.) 
BUFFERS macro 
applicability, (table) 2-4 
DISCFILE macro, 2-36 
examples, 2-12 
format, 2-3 
global networks, 3-42 
journal file, 4-9 
operands, 2-5 
statistics areas, 4-17 
Telcon network, A-9 
use, 2-3 
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C 


CACH macro, COMMCT, A-14 
CACH statement, 5-4 
CALL operand 

LINE macro, 2-62 

STATION macro, 2-110 

TERM macro, 2-142 
Call progress signal 

action default values, (table) 2-27 

LDTE macro, 2-52 

table, creating, 2-26 
Calling line, identification, 2-52 
Calling number, local DTE, 2-52 
CALLING operand, SUB macro, 2-114 
CALL NO operand 

SUB macro, 2-114 

TRUNK macro, 2-156 
Calls, TRUNK macro, 2-156 
Card processors 

LINE macro, 2-61 

standard interface network definition, 

3-14 

TERM macro, 2-132, 2-141 
CARRIER operand, PDN macro, 2-90 
CAT operand, CONGRP macro, 2-25 
CATP operand 

LPORT macro, 2-87 

SUB macro, 2-114 
CC statement, 5-5 
CCA macro 

applicability, (table) 2-15 

DCA global networks, 3-46 

examples, 2-22 

format, 2-14 

journaling, 4-8 

operands, 2-17 

single-node global networks with remote 

workstations, 3-42 

Telcon network, A-12 

use, 2-14 
CCAID operand, CCA macro, 2-17 
CCAMOD parameter, ICAM generator, 5-1 
CGRPEND macro, 2-23 
CHAN operand 

LINE macro, 2-62 

VLINE macro, 2-165, A-25 
Channel characteristics, DCP, 2-31 
Channel number, 2-32, A-14 
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CHANNEL statement, A-2 
Channels, virtual, VLINE macro, 2-161 
Character detect table, LINE macro, 2-63 
Character interpret table, LINE macro, 2-63 
CIRCSW operand, LINE macro, 2-63 
Circuit-switched public data network 
call progress signal, (table) 2-26 
DATEX-L (See DATEX-L PDN.) 
defining local data terminal equipment, 
2-50 
network definition, 3-55 
NORDIC (See NORDIC PDN.) 
PDN macro, 2-91 
remote data terminal equipment, RDTE 
macro, 2-101 
Circuits 
permanent virtual (See Permanent virtual 
circuit.) 
switched virtual (See Switched virtual 
circuits.) 
Closed user group 
code, 2-114 
number (RDTE), 2-103 
CMDADDR operand, VLINE macro, 2-165, 
A-25 
CMWO operand, EUP macro, 2-45 
Cn/Mn operator command, 5-5 
CNID operand, DCPCHNL macro, 2-32, 
A-14 
COBOL programs, LOCAP macro, 2-83 
Collect calls, SUB macro, 2-115 
COMMCT phase 
ICAM generation, 5-1 
sample, 5-2 
Communications, system console, 5-13 
Communications output printer (COP), 3-16 
Communications physical interface (CPI) 
CCA macro, 2-21 
definition, 1-3 
Communications user program, 5-6 
Computer message waiting 
message, 2-147 
sentinel, 2-45 
Computer nodes, VLINE macro, 2-161 
Configuration group 
indicating end, 2-23 
UDLC/NRM line, 2-24 
CONGRP macro, 2-24 


UP-9745 Rev. 3 











Connection processing, line initialization, 
2-25 
CONTYP operand, CONGRP macro, 2-25 
Console type-ins, 5-13 
Control areas, disk queuing file, 2-35 
Control page, destructive space, 2-20, 2-64 
Control tables, user data unit, A-11 
Control unit address, DCPCHNL macro, 
2-32, A-14 
Control unit addresses, (table) C-1 
CPI (See Communications physical 
interface.) 
CPS operand, CPSTB macro, 2-29 
CPSTB macro 
applicability, (table) 2-28 
call progress signal action default values, 
(table) 2-27 
examples, 2-30 
format, 2-26 
LDTE macro, 2-52 
NORDIC PDN, 3-56, 3-60, 3-66 
operands, 2-29 
use, 2-26 
CPSTBL operand, LDTE macro, 2-52 
CPU-CPU BSC connection, 2-58 
CSU, A-6 
CTABLE operand, LINE macro, 2-63 
CU/DEV addresses, (table) C-1 
CUG operand, SUB macro, 2-114 
CUGADDR operand, RDTE macro, 2-103 


D 


Data communications terminals (DCT) 
LINE macro, 2-59 
TERM macro, 2-126, 2-134, 2-141 
(See also Terminals.) 
Data circuit-terminating equipment (DCE) 
packet-switched PDNs, 3-68 
TRUNK macro, 2-154 
VLINE macro, 2-168 
Data packets, TRUNK macro, 2-156 
Data terminal communications equipment 
(DCE) 
circuit-switched PDNs, 3-55 
VLINE macro, 2-161 
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Data terminal equipment (DTE) 
address, local subscriber, 2-154 
circuit-switched PDN, 3-55 
local, defining, 2-50 
packet-switched PDN, 3-68 
remote (See Remote data terminal 
equipment.) 
remote subscriber, 2-112 
TRUNK macro, 2-154 
VLINE macro, 2-161 
DATAPAC public data network 
network definition, 3-55, 3-81 
three-node coding, network definition, 
(figure) 3-87 
two-node coding, network definition, 
(figure) 3-83 
two-node environment, (figure) 3-82 
VLINE macro, 2-164 
DATATIM operand, TRUNK macro, 2-156 
Date stamp, queued messages, 2-19 
DATEX public data network 
network definition, 3-55, 3-81 
two-node environment, (figure) 3-82 
DATEX-L public data network 
dedicated network definition, (figure) 
3-90 
description, 3-89 
environment, typical, (figure) 3-59 
global network definition, (figure) 3-90 
LINE macro, 2-63 
network definition, 3-55 
TERM macro, 2-144 
DCA (See Distributed communications 
architecture.) 
DCA operand, CCA macro, 2-18, A-12 
DCATS statement, A-2 
DCP 
channel characteristics, 2-31 
downline or cross-channel loading, 2-18 
DCPCHNL macro, 2-31, A-13 
DCPLOAD operand, CCA macro, 2-18, A-13 
DCPTS statement, A-3 
DCT (See Data communications terminals.) 
DDI (See Direct data interface.) 
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DDX public data networks 
coding, three nodes, (figure) 3-77 
network definition, 3-55, 3-73 
SUB macro, 2-114 
three-node, 3-73 
three-node environment, (figure) 3-74 
virtual circuit group, 2-158 
Dedicated networks 
CCA macro, 2-17 
defining, 3-6 
direct data interface definition, 3-6 
interfaces, 1-2 
line characteristics, 2-53 
macroinstruction usage by network 
definition type, (table) 3-2 
standard interface definition, 3-9 
transaction control interface definition, 
3-18 
Demand mode interface (DMI), 1-2 
DESPACE operand 
CCA macro, 2-18 
LINE macro, 2-64 
TERM macro, 2-143 
Destination node 
LOCAP macro, 2-84 
LPORT macro, 2-87 
Destructive space specification 
CCA macro, 2-21 
LINE macro, 2-64 
TERM macro, 2-143 
Device addresses 
TERM macro, 2-134 
with EBCDIC I/O characters and 
hexadecimal values, (table) C-1 
Device independent control expression 
(DICE) 
sequence, line length, 2-44 
TERM macro, 2-143 
DEVICE operand 
LINE macro, 2-58 
VLINE macro, 2-164, A-24 
DEVICE statement, A-3 
Devices, auxiliary (See Auxiliary devices.) 
DIALER operand, LINE macro, 2-65 
DICE operand, TERM macro, 2-143, A-22 
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Direct-call facility, remote data terminal 
equipment, 2-103 
Direct data interface (DDI) 
activity request packets, 2-8, 2-9 
CCA macro, 2-17 
coding for network definition, (figure) 3-9 
description, 1-2 
macroinstructions, (table) 3-7 
network, (figure) 3-8 
network definition, 3-6 
DIRECT operand, RDTE macro, 2-103 
DISCFILE macro 
applicability, (table) 2-34 
examples, 2-37 
format, 2-33 
operands, 2-35 
use, 2-33, 4-1 
DISIN operand, TERM macro, 2-144 
Disk buffering file 
allocating space, 4-4 
creating, 2-33 
Disk files 
buffering, 2-33, 4-4 
creating, 4-1 
queuing, 4-3, 4-5 
sample job control stream, allocating 
files, (figure) 4-5 
space allocation, 4-3 
TCI network definition, (figure) 4-5 
Disk-queued TCI network with auxiliary 
devices, (figure) 3-19 
Disk-queuing file 
allocating space, 4-3, 4-5 
creating, 2-33 
DISOUT operand, 
TERM macro, 2-144 
Distributed communications architecture 
(DCA) 
CCA macro, 3-89, A-12 
DATEX-L PDNs, 3-89 
global networks, 3-46 
ICAM non-DCA and DCA global 
networks, (figure) 3-24 
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interactive terminal with DCP, (figure) 
3-50 
logical port, 2-85 
multinode, TERM macro, 2-144 
multinode, VLINE macro, 2-161 
multinode DDP with interactive terminal, 
(figure) 3-49 
multinode network definition for DDP, 
(figure) 3-48 
NRM, using, 3-52 
OS/3 to UNIX O/S connectivity, (figure) 
3-54 
Distributed communications processor (DCP) 
DCA global networks, 3-46, (figure) 
3-50, 3-51 
multiple paths, System 80, A-62 
termination systems, A-3 
Distributed data processing (DDP) 
DCA global networks, 3-46, (figure) 3-48 
DCP as intermediate node, (figure) 3-51 
multinode with interactive terminal, 
(figure) 3-49 
Distribution lists 
creating, 2-38 
global networks, 3-25 
DLIST macro, 2-38 
DMI (See Demand mode interface.) 
DSCI operand, RDTE macro, 2-103 
DSCO operand, RDTE macro, 2-103 
Dual-screen devices, TERM macro, 2-128, 
2-130 
DUST macro, errors, 2-18 
DUSTERR operand 
CCA macro, 2-18 
LOCAP macro, 2-82 
DVCGID operand, TERM macro, 2-144, 
A-22 
Dynamic sessions 
DCA global networks, 3-46 
establishing, 6-7 
global networks, 3-37 
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EBCDIC code, LINE macro, 2-58 
EDT operand, EUF macro, 2-44 
END operand, CPSTB macro, 2-29 
End users 
how they communicate, 3-37 
local, 2-87 
profile, 2-43 
remote, 2-87 
static sessions, 2-106 
ENDCCA macro, 2-40, A-15 
Error recovery, LPORT macro, 2-87 
ETB operand, EUP macro, 2-45 
EUF operand, EUP macro, 2-44 
EUP macro 
applicability, (table) 2-42 
controlling message format, 4-6 
examples, 2-46 
format, 2-41 
operands, 2-43 
programming notes, 2-45 
use, 2-41 
EU1 operand 
LPORT macro, 2-87, A-18 
SESSION macro, 2-106 
EU2 operand 
LPORT macro, 2-87, A-19 
SESSION macro, 2-106 
Expansion factor, buffer pool, 2-8, A-10 
EXPFACT operand, BUFFER macro, 2-8, 
A-10 
External termination system, A-2 


F 


FEATURES operand 
CCA macro, 2-19, A-13 
TERM macro, 2-122, A-21 
FILE DIV operand, DISCFILE macro, 2-35 
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Files 
disk, creating, 2-33, 4-1 
journal, creating, 2-47 
process, creating, 2-94 
Format edit (See Message format editing 
feature.) 
Format editing facility, EUP macro, 2-41 
Frames 
level address, VLINE macro, 2-165, 
2-166 
STATION macro, 2-111 


G 


GAWAKE operand, CCA macro, 2-20, A-13 
Global networks 
CCA macro, 2-17 
configurations, 3-21 
creating LOCAP value, 2-80 
DCA, 3-46 
definitions, 1-2, 3-25, 
establishing static sessions, 2-104 
ICAM non-DCA and DCA, (figure) 3-24 
line characteristics, 2-53 
macroinstruction usage by network 
definition type, (table) 3-2 
macroinstructions, order of presentation, 
3-25 
multinode, (figure) 3-23 
single-node 
standard interface, (figure) 3-22, 3-30 
with IMS and local workstations, 3-32 
with IMS and terminals using 
interactive services, 3-35 
with remote workstations, 
using queues, 3-29 
VLINE macro, 2-161 
Global user service task (GUST) 
executing, (figure) 5-8 
global network configurations, 3-21, A-12 
ICAM initialization and shutdown, 5-5 
initialization and shutdown, 5-7 
initializing, 5-8 
loading a communications user program, 
5-6 
remote workstation startup, 6-9 
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HIGH operand 
LINE macro, 2-69 
LOCAP macro, 2-83, 3-29, A-17 
PRCS macro, 2-96 
TERM macro, 2-147, A-22 


I field size, 2-11- 
IAS operand, LOCAP macro, 2-82, A-17 
IBERPAC public data network 

network definition, 3-55, 3-81 

SUB macro, 2-114 

typical 2-node environment, (figure) 2-82 

VLINE macro, 2-164 
IBM 3270 terminal system 

LINE macro, 2-59 

TERM macro, 2-134 
IBM 3277 display station, 2-132, 2-133 
IBM 3284/3286 printer, 2-132 
ICAM (See Integrated communications 

access method.) 

ID operand 

DCPCHNL macro, 2-32, A-14 

LINE macro, 2-65 

VLINE macro, 2-164, A-24 
IMS/TIP30 LOCAP, 2-125 
Incoming calls, LDTE macro, 2-52 
Information management system (IMS) 

CCA macro, 2-17 

DCA global networks, 3-46 

LINE macro, 2-58 

single-node global networks, 3-32 

TCI network definition, 3-18 
INHIBIT operand, TERM macro, 2-144 
INID operand, LDTE macro, 2-52 
INPUT operand 

LINE macro, 2-67 

TERM macro, 2-145, A-22 
Input/output microprocessor 

LINE macro, 2-62, 2-65 

VLINE macro, 2-164 
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Input queues, priority, 2-69, 2-83 
Input record size, batch terminals, 2-146 
Input translation, TERM macro, 2-153 
Input window size 
permanent virtual circuit, 2-100 
switch virtual circuit, 2-114 
INONLY operand, TERM macro, 2-144 
INRECSZ operand, TERM macro, 2-146 
Integrated communications access method 
(ICAM) 
general comments, A-62 
generating, 5-1 
GUST, 5-7 
incorporating features, 4-1 
initialization and shutdown, 5-5 
interfaces (See Interfaces.) 
loading an ICAM symbiont, 5-5 
macroinstructions 
(See Macroinstructions.) 
network definition (See Network 
definition.) 
networks (See Networks.) 
supported terminals, maximum line 
speed, (table) 2-75 
system console communications, 5-13 
Telcon (See Telcon.) 
terminal operations (See Terminals.) 
Interactive services 
DCA global networks, 3-46 
LOCAP macro, 2-84 
single-node global networks with IMS, 
3-35 
Interactive terminal 
DCP, global network, (figure) 3-50 
multinode DDP, DCA global networks, 
(figure) 3-49 
INTERCEPT operand, TERM macro, 2-146 
Interfaces 
activity request packets, 2-8 
dedicated networks (See Dedicated 
networks.) 
global networks (See Global networks.) 
special, 1-3 
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IOSVC operand, TRUNK macro, 2-156 
ISVC operand, TRUNK macro, 2-156 
IWS operand 

PVC macro, 2-100 

SUB macro, 2-114 


J 


Job control streams 
sample, allocating disk queuing and 
buffering files, (figure) 4-5 
sample, executing a user program, 
(figure) 5-7 
sample, executing GUST, (figure) 5-8 
JOBINIT operand, LOCAP macro, 2-83 
JOBNAME operand, LOCAP macro, 2-83 
JOURN macro, 4-10 
Journal file 
allocating, 4-13 
buffer and terminal statistics, 4-9, 
(figure) 4-11 
creating, 2-47, 4-8 
global networks, 3-25 
Journal records, 4-8 
Journal utility, 2-47, 4-7 
Journaling 
allocating journal file, 4-13 
building journal file, 4-8 
description, 4-7 
routines, CCA macro, 2-20 
sample network definitions, 4-10 
types of records, 4-8 
JRNFILE macro 
description, 2-47 
journal file, 4-9, 4-13 
JRNINIT operand, CCA macro, 2-20 


K 


K operand, VLINE macro, 2-165, A-25 
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L 


LBL operand, LINE macro, 2-68 
LBUF operand, VLINE macro, 2-165 
LCGN operand 
PVC macro, 2-100 
VCGROUP macro, 2-159 
LCN operand, PVC macro, 2-100 
LDTE macro 
circuit-switched PDN, 3-56 
description, 2-50 
NORDIC PDN, 3-60, 3-66 
Leased lines, SLCA ports, (figure) 2-66 
LGROUP operand, LDTE macro, 2-52 
Line editing argument, 2-44 
Line length, 2-44 
LINE macro 
applicability, (table) 2-56 
CALL operand, 2-62 
CHAN operand, 2-62 
CIRCSW operand, 2-63 
CTABLE operand, 2-63 
DATEX-L PDN, 3-89 
DESPACE operand, 2-64 
DEVICE operand, 2-57 
DIALER operand, 2-65 
example, 2-79 
format, 2-53 
global networks, 3-42 
HIGH operand, 2-69 
ID operand, 2-65 
INPUT operand, 2-67 
journal file, 4-9 
LBL operand, 2-68 
line characteristics and TYPE 
specifications, (table) 2-74 
line-speed value, (table) 2-75 
local workstation configuration, B-8 
LOW operand, 2-69 
maximum line speed of ICAM-supported 
terminals, (table) 2-75 
MEDIUM operand, 2-69 
NORDIC PDN, 3-66 
PDN network definition, 3-55- 
RDHLQ operand, 2-69 
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RECONECT operand, 2-70 
RETRY operand, 2-70 
STATS operand, 2-71 
TIMEOUT operand, 2-72 
translation tables, 4-14 
TYPE operand, 2-73 
use, 2-53 
XLATE operand, 2-78 
LINE operand 
LPORT macro, 2-86, A-18 
STATION macro, 2-110 
Lines 
automatic dialing, 2-77 
automatic turnaround, 2-76 
buffer length, 2-57, 2-68 
devices connected, 2-57 
leased, specifying SLCA ports, 
(figure) 2-66 
local DTE, 2-52 
maximum speed of ICAM-supported 
terminals, (table) 2-75 
performance records, 4-8 
profile, 2-43 
queuing, 2-53, 2-146 
reconnection, 2-69 
specifying characteristics, 2-53, 2-73, 
(table) 2-74 
speed, 2-73, 2-68, 2-167 
speed values, (table) 2-75 
switched, 2-77, 3-53 
synchronous transmission, 2-77 
TYPE specifications, (table) 2-74 
unattended answering, 2-77 
Link buffer pool, Telcon, A-8 
Link buffers 
length, 2-10, A-11 
number, 2-9, A-10 
specifying, 2-9, A-11 
statistics areas, 2-9 
Link control, station, 2-110 
Link level protocol, CONGRP macro, 2-24 
LINKPAK operand, BUFFERS macro, 2-9, 
A-10 
Links, physical, VLINE macro, 2-161, 
2-164 ; 
Loading an ICAM symbiont, 5-5 
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Local data terminals, defining equipment, 
2-50 
Local data terminating equipment (LDTE), 
3-66 
Local end user 
defining, 2-87 
static sessions, 2-104 
Local workstation 
generation and logon/sign-on procedures, 
(table) 6-2 
LINE macro, 2-59 
log on, 6-10 
releasing from ICAM, 6-12 
single-node global network, 3-32 
specifying, 6-4 
startup procedures, 6-10 
TERM macro, 2-132, 2-137 
UTS 20/40/400 terminals, B-8 
LOCAP files 
DCA global networks, 3-46 
defining (See LOCAP macro.) 
global networks, 3-21, 3-25, 3-32, 3-42 
Telcon networks, A-16 
LOCAP macro 
applicability, (table) 2-81 
DDX PDN, 3-75 
format, 2-80 
NORDIC PDN, 3-60 
operands, 2-82 
PDN network definition, 3-55 
queues in global networks, using, 3-29 
Telcon network, A-16 
use, 2-80 
Logical channel group number 
permanent virtual circuit, 2-100 
VCGROUP macro, 2-159 
Logical channel number, 2-100 
Logon procedures, terminals and 
workstations, (table) 6-2 
LOW operand 
LINE macro, 2-69 
LOCAP macro, 2-78, 3-29, A-17 
PRCS macro, 2-96 
TERM macro, 2-147, 3-29, A-22 
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circuit-switched PDN, 3-56, 3-60 
description, 2-85 
Telcon network, A-18 


L3MOD operand, PDN macro, 2-90 


Macroinstructions 


BUFFERS, 2-3, A-9 

CCA, 2-14, A-12 

CGRPEND, 2-23 

circuit-switched PDN network definition, 
(table) 3-55, (table) 3-57 

CONGRP, 2-24 

CPSTB, 2-26 

DCPCHNL, 2-31, A-14 

DDI network definition, (table) 3-7 

DISCFILE, 2-33 

DLIST, 2-38 

ENDCCA, 2-40, A-15 

EUP, 2-41 

global network definition, 3-25, (table) 
3-26 

JRNFILE, 2-47 

LDTE, 2-50 

LINE, 2-53 

listing, 2-1 

LOCAP, 2-80, A-16 

LPORT, 2-85, A-18 

packet-switched PDN network definition, 
(table) 3-70 

PDN, 2-88 

PGROUP, 2-92 

PRCS, 2-94 

PVC, 2-98 

RDTE, 2-101 

SESSION, 2-104 

standard interface network definition, 
(table) 3-10 

STATION, 2-108 

SUB, 2-112 

TCI network definition, (table) 3-10 
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Telcon, A-7 
Telcon/ICAM macroinstruction 
relationships, (table) A-26 
TERM, 2-116, A-20 
TRUNK, 2-154 
usage by network definition type, (table) 
3-2 
VCGROUP, 2-158 
VLINE, 2-161 
MAPPER 5 system, LINE macro, 2-60, 2-68 
MAXIFLD operand, STATION macro, 2-110 
MCP parameters 
description, 5-1 
format, 5-4 
MEDIUM operand 
LINE macro, 2-69 
LOCAP macro, 2-83, 3-29, A-17 
PRCS macro, 2-96 
TERM macro, 2-147, 3-29, A-22 
Message control program (MCP), 5-1, 5-4 
Message dequeuing notices, 4-8 
Message format editing feature 
description, 4-6 
TERM macro, 2-149 
Message header, 2-5 
Message processing routine 
journaling, (figure) 4-12 
standard interface dedicated network 
definition, 3-14 
Messages 
controlling format, 4-6 
date and time stamp, 2-19 
GUST, 5-8 
input, destination, 2-67, 2-145 
list of destination, 2-38 
output, editing, 2-41 
output, queuing, 2-146 
priority, 2-94 
process files, 2-94 
segmented, 2-19 
terminal (See TERM macro.) 
time-out values, 2-72 
Mode of operation, 2-37 
MODE operand, LOCAP macro, 2-84 
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MSGWAIT operand, TERM macro, 2-147 
MSGSIZE operand, DISCFILE macro, 2-33 
Multinode networks 
DCA global networks, 3-46 
DDP with interactive terminal, (figure) 
3-49 
global network configurations, 3-19, 
(figure) 3-23 
LOCAP macro, 2-84 
PRCS macro, 2-97 
Multiple paths, System 80 and DCP, A-62 
MUX operand, SUB macro, 2-114 
MXCALL operand, RDN macro, 2-90 


NEGO operand, SUB macro, 2-115 
Negotiator option, SUB macro, 2-115 
Networks 
buffer pools, specifying, 2-3 
CCA macro, 2-14, A-12 
dedicated (See Dedicated networks.) 
definition (See Network definitions.) 
general characteristics, specifying, 2-14 
global (See Global networks.) 
interfaces, 1-2 
line characteristics, 2-53 
multinode, 2-84 
OS/3 configurations, (table) 3-4 
relating Telcon and ICAM networks, A-1 
Telcon (See Telcon.) 
(See also Public data networks.) 
Network buffers 
pool usage, 4-17 
specifying, 2-3 
statistics, 2-11, 2-20, A-11 
statistics area format, (figure) 4-18 
statistics area sample, (figure) 4-19 
Telcon network, A-9 
(See also Buffer pools.) 
Network definitions 
DCA global, 3-46 
dedicated, 3-6 
description, 1-1 
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direct data interface, 3-6 
ending, 2-40, A-15 
global, 1-2, 3-21 
indicating end, 2-40 
journaling, 4-10 
macroinstruction usage by network type, 
(table) 3-2 
macroinstructions (See 
Macroinstructions.) 
preparing, 3-1 
public data networks, 3-55 
saving copy, 2-21 
standard interface, 3-9 
starting, 2-14 
Telcon (See Telcon.) 
user-own-code translation table, 4-14 
Nine thousand remote (NTR), 1-3 
Node identifier, CCA macro, 2-17 
Nodes 
intermediate, DCA global networks, 
(figure) 3-51 
VLINE macro, 2-161 
NOR operand, CPSTB macro, 2-29 
NORDIC public data network 
end-user sessions, (table) 3-64 


environment 
computer to computer, (figure) 3-59 
computer to UTS 20X terminal, 
(figure) 3-65 
network definitions, 3-55, (figure) 3-61, 
(figure) 3-67 
NRM 


configuration group, 2-23, 2-24 
DCA network, 3-52 
NTR (See Nine thousand remote.) 
NUMBER operand, VCGROUP macro, 
2-160 


0) 


ODNKR records, 4-8 
OPCOM operand, BUFFERS macro, 2-11 
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Operating System/3 (OS/3), basic network 
configuration, (table) 3-4 
DCA global networks, 3-52 
sample Telcon network configurations, 
A-29 

Operator communications packets, 2-11 
OSVC operand, TRUNK macro, 2-156 
OUTBARD operand, LDTE macro, 2-52 
Outgoing calls, LDTE macro, 2-52 
OUTID operand, LDTE macro, 2-52 
OUTONLY operand, TERM macro, 2-148 
Output delivery notice 

CCA macro, 2-19, A-13 

producing records, 2-20 
Output line, length, 2-44 
Output messages, editing, 2-41 
Output translation, TERM macro, 2-153 
Output window size 

permanent virtual circuit, 2-100 

switched virtual circuit, 2-115 
OWS operand 

PVC macro, 2-100 

SUB macro, 2-115 


P 


Packet-switched public data networks 
DATAPAC, TRANSPAC, DATEX, 
IBERPAC PDNs, 3-81 

defining a permanent virtual circuit, PVC 

macro, 2-98 

environment, (figure) 3-69 

LOCAP file, 2-84 

network definition, 3-68 

PDN macro, 2-91 

remote subscriber, 2-112 

static sessions, 2-104 

three-node DDX, 3-73 

trunk definition, 2-154 
Packets, data, TRUNK macro, 2-156 
Page profile, 2-43 
PASSWORD operand, CCA macro, 2-21 
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PDN macro 
description, 2-88 
packet-switched PDN, 3-70 
PDN network definition, 3-55 
NORDIC PDN, 3-56, 3-60, 3-66 
Performance records, line and terminal, 
2-20 
Permanent virtual circuit (PVC) 
DDX PDN, 2-158 
defining, PVC macro, 2-98 
number provided by PDN, TRUNK 
macro, 2-156 
packet-switched PDNs, 3-68 
PSS PDN, 2-158 
static sessions, 2-104, 2-106 
PGID operand, PGROUP macro, 2-93 
PGROUP macro 
description, 2-92 
global networks, 3-42 
NORDIC PDN, 3-66 
Physical links, VLINE macro, 2-161, 2-164 
PINTV operand, TERM macro, 2-148 
PKTSIZ operand, PDN macro, 2-91 
PLIMIT operand, TERM macro, 2-149 
Polling groups downed, slow polling interval, 
2-151 
Polling intervals, PGROUP macro, 2-92 
Polling pass, TERM macro, 2-149 
Polls, time between, 2-148 
Pools 
ARP (See Activity request packet.) 
buffer (See Buffer pools.) 
specifying, 2-3 
Port control word, LINE macro, 2-63 
Port number, 2-87 
PORT operand, LPORT macro, 2-87, A-18 
Ports 
DCA logical, 2-85 
flow control, SUB macro, 2-114 
SLCA, specifying, (figure) 2-66 
PRCS macro 
applicability, (table) 2-95 
circuit-switched PDN, 3-60 
example, 2-97 
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format, 2-95 
operands, 2-96 
use, 2-94 
PREN operand, EUP macro, 2-43 
Programs 
communications, loading, 5-5 
definition, 1-3 
PRI operand, LPORT macro, 2-87, A-19 
PRIMARY operand, SESSION macro, 2-105 
Primary session, specifying, (figure) 2-106 
Priority, remote device handler, 2-124 
Priority queues 
global networks, 3-29 
input LINE macro, 2-83, 3-29 
LPORT macro, 2-87 
messages, 2-94 
output, LINE macro, 2-69 
output, TERM macro, 2-147, 3-29 
Process files 
creating, PRCS macro, 2-94 
defining label of alternate, 2-137 
establishing a session, 6-7 
global networks, 3-21, 3-25 
how queues are accessed, (table) 2-96 
queues in global networks, 3-29 
PROFIL operand, TERM macro, 2-149 
Profile 
end user, 2-43 
number, 2-149 
Program queues, global networks, 3-29 
Programs, user-written, global networks, 
with IMS, 3-32 
PROTYP operand, TERM macro, 
2-149, A-22 
PSEUDO operand, TERM macro, 
2-149, A-22 
PSS public data network 
network definition, 3-55 
SUB macro, 2-115 
PTIME operand, PGROUP macro, 2-93 
Public data networks 
circuit-switched (See Circuit-switched 
public data networks.) 
DATAPAC (See DATAPAC PDN.) 
DATEX (See DATEX PDN.) 
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DATEX-L (See DATEX-L PDN.) 
DCA global networks, 3-46 
DDX (See DDX PDN.) 
defining, PDN macro, 2-88 
defining a trunk, 2-154 
defining virtual circuit group, 2-158 
IBERPAC (See IBERPAC PDN.) 
NORDIC (See NORDIC PDN.) 
packet-switched (See Packet-switched 
public data network.) 

programming ICAM, 3-55 
PSS (See PSS PDN.) 
remote subscribers, SUB macro, 2-114 
TRANSPAC (See TRANSPAC PDN.) 
virtual channels, 2-161 
X-21, LINE macro, 2-61 
(See also Networks.) 

PVC macro 
description, 2-98 
packet-switched PDN, 3-70 

PVC operand 
SESSION macro, 2-106 
TRUNK macro, 2-156 


Q 


Queuing 
line, 2-53 
two-way simultaneous, 2-73 
Queues 
global networks, 3-29 
priority (See Priority queues.) 


RBATCH operand, TERM macro, 2-149 
RBP (See Remote batch processing.) 
RDHLQ operand, LINE macro, 2-69 
RDTE macro 

description, 2-101 

NORDIC PDN, 3-56, 3-66 
Receive-only device, 2-148 
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RECONNECT operand, LINE macro, 2-70 
Records, journaling, 4-8 
Remote batch jobs, TERM macro, 2-149 
Remote batch processing (RBP), 1-3, 2-17 
Remote data terminal equipment (RDTE) 
defining, RDTE macro, 2-101 
NORDIC PDN, 3-56, 3-66 
Remote device handlers 
automatic line buffering, 2-19 
LINE macro, 2-60 
priority, 2-124 
VLINE macro, 2-166 
Remote end user 
defining, 2-87 
static sessions, 2-106 
Remote identifier, TERM macro, 2-134 
Remote node, TERM macro, 2-149 
REMOTE operand 
DCPCHNL macro, 2-29, A-14 
LOCAP macro, 2-84, 3-29, A-17 
LPORT macro, 2-85, A-18 
PRCS macro, 2-97 
STATION macro, 2-111 
TERM macro, 2-149, A-23 
Remote session entry table, LPORT macro, 
2-85, A-18 
Remote subscriber, SUB macro, 2-112 
Remote terminal group, TERM macro, 
2-144 
Remote workstations 
generation and logon/sign-on procedures, 
(table) 6-2 
LINE macro, 2-60 
LOCAP macro, 2-84 
log on, 6-10 
polling groups, 2-92 
single-node global networks, 3-42 
specifying, 6-5 
startup procedures, 6-10 
UTS 20/40/400 terminals, B-9 
(See also Workstations.) 
Reports, journal utility, 4-7 
Request-to-send signal, 2-73 
Restart, warm, 2-19 
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Restart records, 2-19, 4-8 
RETRY operand 
LINE macro, 2-70 
VLINE macro, 2-166 
REVCHG operand, SUB macro, 2-115 
RSPADDR operand, VLINE macro, 2-166, 
A-25 
RTIMER operand, BUFFERS macro, 2-12, 
A-11 


S 


SAVE operand, CCA macro, 2-21 
Screen number, TERM macro, 2-134 
SCREENS operand, TERM macro, 2-150 
Segmented message processing, CCA macro, 
2-19 
Send-only device, 2-144 
Session control, SUB macro, 2-114 
Session entry table, remote, 2-85 
SESSION macro 
DCA global networks, 3-46 
DDX PDN, 3-75 
description, 2-104 
global networks, 3-37 
packet-switched PDN, 3-70 
Sessions 
defining, A-4 
dynamic (See Dynamic sessions.) 
establishing, 6-7 
global networks, 3-37 
OS/3 ICAM static, A-62 
SESSION macro, 2-104 
static (See Static sessions.) 
SESSN statement, A-4 
Sign-off command ($$SOFF), 6-9 
Sign-on commands 
$$SON, 6-7 
$$OPEN, 6-9 
SIGNON operand, CCA macro, 2-21 
Sign-on procedures, summary, (table) 6-2 
Single-line communications adapter (SLCA) 
CPSTB macro, 2-29 : 
defining ports, 2-65, (figure) 2-66 
LINE macro, 2-62, 2-63, 2-65 
VLINE macro, 2-165 
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Single-node global networks 
definition, 3-4 
global network configurations, 3-21 
IMS and local workstations, 3-32 
IMS and terminals using interactive 
services, 3-35 
remote workstations, 3-42 
standard interface, (figure) 3-22, 3-30, 
(figure) 3-31 
Site identifier codes, TERM macro, 2-138 
Slow polling interval, 2-151 
Spooling, OS/3 terminal, A-63 
SPR operand, TERM macro, 2-151 
Staging areas, journal files, 2-49 
Standard interface (STDMCP) 
basic definition, 3-11 
CCA macro, 2-17, A-12 
creating disk files, 4-2 
DCA global networks, 3-46 
description, 1-2 
macroinstructions, order of presentation 
for network definition, (table) 3-10 
network definition, 3-9 
network definition using a message 
processing routine, 3-14 
network definition with auxiliary devices, 
3-16 
network with auxiliary devices, (figure) 
3-17 
network with no auxiliary devices, 
(figure) 3-12, (figure) 3-13 
single-node global network, (figure) 3-22, 
3-30, (figure) 3-31 
STAT operand, BUFFERS macro, 2-11, 
A-11 
Static sessions 
global network definition, 3-25, 3-32, 
3-37 
global networks, 2-104 
OS/3 ICAM, A-62 
Station identifier, TERM macro, 2-134 
STATION macro, 2-108 
STATION statement, A-4 
Statistics 
maintaining, 2-20 
terminals, 2-71 
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Statistics areas 
buffer pools, 2-11 
format, (figure) 4-18 
sample dump, (figure) 4-19 
tracking buffer pool usage, 4-17 
STATS operand, LINE macro, 2-71 
STDMCP (See Standard interface.) 
SUB macro 
applicability, (table) 2-113 
DDX PDN, 3-75 
format, 2-112 
operands, 2-114 
packet-switched RDN, 3-70 
PVC macro, 2-98 
use, 2-112 
SVT emulation, OS/3 to UNIX O/S 
connectivity, (figure) 3-54 
SVT local workstations, TERM macro, 
2-132, 2-139, 2-142 
Switched lines 
DCA global networks, 3-53 
LINE macro, 2-76 
Switched virtual circuits 
packet-switched PDNs, 3-68 
SUB macro, 2-114, 2-115 
TRUNK macro, 2-156 
VCGROUP macro, 2-158 
Symbiont, ICAM 
creating, 5-5 
definition, 1-3 
loading, 5-5 
Synchronous transmission lines, 2-77 
System activity monitor (SAM), CCA macro, 
2-19 
System console communications, 5-13 
System 80 
multiple paths, DCP, A-62 
PDNs, 3-55 
System generation, ICAM, 5-1 
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Tape cassette system (TCS), standard 
interface network definition, 3-16 

TBR operand, CPSTB macro, 2-29 

TCI (See Transaction control interface.) 

TCTUPD operand, TERM macro, 2-151 
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front-end processor addressing, 2-31 

macroinstructions, A-7 

network definition statements, A-2 

relating Telcon and ICAM networks, A-1 

sample network configurations, A-29 

Telcon/ICAM macroinstruction 
relationships, (table) A-26 

Telcon/ICAM terminal] operation 
comparison, A-27 

TERM macro, 2-144, 2-149 

VLINE macro, 2-161 


Teletypewriters 


LINE macro, 2-60 

standard interface network definition, 
3-14 

TERM macro, 2-126, 2-141 


TERM macro 


ADDR operand, 2-134 
ALTD operand, 2-137 
ANSWER operand, 2-138 
applicability, (table) 2-120 
AUX operand, 2-138 

BSC, 2-123 

CALL operand, 2-142 
DATEX-L PDN, 3-89 
DCA global networks, 3-46 
DCT 475/500/524, 2-126 
DCT 2000, 2-126 
DESPACE operand, 2-143 
DICE operand, 2-143 
DISIN operand, 2-144 
DISOUT operand, 2-144 
DVCGID operand, 2-144 
FEATURES operand, 2-122 
format, 2-116 

global networks, 3-29 
HIGH operand, 2-147 
IBM 2780/3780, 2-123 
IBM 3271, 2-132 

IBM 3277, 2-132, 2-133 
INHIBIT operand, 2-144 
INONLY operand, 2-144 
INPUT operand, 2-145 
INRECSZ operand, 2-146 
INTERCPT operand, 2-146 
journal file, 4-9 

LOW operand, 2-147 
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MEDIUM operand, 2-147 
MSGWAIT operand, 2-147 
NORDIC PDN, 3-60, 3-66 
OUTONLY operand, 2-148 
PDN network definition, 3-55 
PINTV operand, 2-148 
PLIMIT operand, 2-149 
PROFIL operand, 2-149 
PROTYP operand, 2-149 
PSEUDO operand, 2-149 
RBATCH operand, 2-149 
REMOTE operand, 2-149 
SCREENS operand, 2-150 
SPR operand, 2-151 
SVT 1120/1123/1124, 2-139 
SVT 1122, 2-132, 2-142 
TCTUPD operand, 2-151 
Telcon network, A-20 
TIMEFILL operand, 2-152 
translation tables, 4-14 
TTY/UTS 10, 2-126 
UDS 2000, 2-130 
UNISCOPE 100/200, 2-130, 2-131 
use, 2-116 
UTS 10, 2-126 
UTS 20, 2-127, B-2 
UTS 40, 2-129, B-4 
UTS 400, 2-131, B-1 
UTS 400 TE, 2-132 
V77 system, 2-130 
XLATE operand, 2-152 
1004 card processor, 2-132 
9200 system, 2-134 
9300 system, 2-134 
TERM statement, A-5 
Terminal performance records, 4-8 
Termination systems within DCP, A-3 
Terminals 
configuring, 6-1 
controlling message format, 4-6 
DCA global networks, 3-49, 3-50 
defining, Telcon network definition, A-5 
dialing, 2-62 
dynamic sessions, 6-7 
end-user communications, 3-37 
generation and logon/sign-on procedures, 
(table) 6-2 
global network configurations, 3-21 
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input message destination, 2-67 
line buffer length, 2-58, 2-59, 2-68 
LINE macro, 2-58 to 2-61 
line speed, (table) 2-75 
local data, defining equipment, 2-50 
single-node global networks with IMS, 
3-35 
specifying, 6-1 
specifying characteristics, TERM macro, 
2-116, A-20 
specifying ICAM terminals to emulate 
workstations, 6-4 
specifying local workstation, 6-4 
specifying remote workstation, 6-5 
spooling, A-62 
startup procedure, terminal used as a 
workstation, 6-12 
statistics, 2-71 
Telcon/ICAM comparison, A-27 
UTS 20/40/400, configuring, B-1 
THRESH operand, DISCFILE macro, 2-34 
Threshold value 
BUFFERS macro, 2-6, 2-9, A-10 
DISCFILE macro, 2-36 
VLINE macro, 2-165 
Time stamp, queued messages, 2-19 
TIMEFILL operand, TERM macro, 2-152 
TIMER operand, RDTE macro, 2-103 
Timer stack entries, 2-11, A-11 
TIMEOUT operand 
LINE macro, 2-72 
VLINE macro, 2-167 
Timeout values 
data packet, TRUNK macro, 2-156 
LINE macro, 2-72 
VLINE macro, 2-166 
TIP30 users, 2-58 
Transaction control interface (TCI) 
CCA macro, 2-17 
creating disk files, 4-1 
definition, 1-2 
disk-queued TCI network with auxiliary 
devices, (figure) 3-19, (figure) 3-20 
macroinstructions used in network 
definition, (table) 3-10 
network definition, 3-18 
network definition using disk files, 
(figure) 4-5 
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TRANSCODE code, LINE macro, 2-58 
Translation tables 
incorporating your own, 4-14 
LINE macro, 2-78 
TERM macro, 2-152 
TRANSPAC public data network 
network definition, 3-55, 3-81 
two-node environment, (figure) 3-82 
VLINE macro, 2-164 
Transparency feature, TERM macro, 2-124 
Transparent input records, 2-122 
TRUNK macro 
applicability, (table) 2-155 
DDX PDN, 3-73 
format, 2-154 
operands, 2-156 
packet-switched PDN, 3-70 
PVC macro, 2-98 
SUB macro, 2-112 
use, 2-154 
Two-way alternate mode, 2-110 
TYPE operand 
CCA macro, 2-17, A-12 
CONGRP macro, 2-25 
JRNFILE macro, 2-45 
LINE macro, 2-73 
LOCAP macro, 2-82, A-16 
PDN macro, 2-91 
STATION macro, 2-110 
VCGROUP macro, 2-160 
VLINE macro, 2-167, A-25 
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UDLC links, A-62 
UDLC/NREM networks 
link, configuring groups, 2-24 
LPORT macro, 2-85 
VLINE macro, 2-164 
UDLC stations, A-4 
UDUCT operand, BUFFERS macro, 2-12, 
A-11 
Unattended answering 
LINE macro, 2-77 
VLINE macro, 2-168 
Unattended lines, reconnection, 2-69 
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UNISCOPE 
CCA macro, 2-19 
end-user communications, 3-38 
LINE macro, 2-61 
standard interface network definition, 
3-14 
TERM macro, 2-130, 2-134, 2-139, 
2-142, 2-151 
Universal data link control, frame level 
address, 2-166 
UNIX 
DCA global networks, 3-52 
VLINE macro, 2-161 
Unsolicited console type-ins, CCA macro, 
2-19, A-13 
User data unit control table (UDUCT) 
specifying, 2-3, 2-12, A-11 
statistic areas, 2-11 
User programs 
communications, loading, 5-6 
establishing a session, 6-8 
GUST, 5-7 
User-written programs, global networks 
with IMS, 3-32 
USERS operand, CCA macro, 2-21 
USERTP operand, LPORT macro, 2-87, 
A-19 
UTS universal terminal systems 
configuring, B-1 
end-user communications, 3-55 
LINE macro, 2-61 
standard interface network definition, 
3-16 
TERM macro, 2-131, 2-134, 2-139, 
2-142 
(See also Terminals.) 
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VCGROUP macro, 2-158 
Virtual channels, VLINE macro, 2-161, 
A-24 
Virtual circuit group, 2-149 
Virtual circuits 
permanent (See Permanent virtual 
circuits.) 
switched (See Switched virtual circuits.) 
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Virtual lines 
CONGRP macro, 2-24 
general comments, A-62 
global network configurations, 3-21 
name, 2-110 
station profile table, 2-108 


Workstations 








configuring, 6-1 

generation and logon/sign-on procedures, 
(table) 6-2 

end-user communications, 3-37, 3-38 

ICAM terminals, 6-4 


VLINE macro 

applicability, (table) 2-163 
DDX PDN, 3-75 
format, 2-161 
NORDIC PDN, 3-56, 3-60 
operands, 2-164 
packet-switched PDN, 3-70 
PDN network definition, 3-55 


line buffer length, 2-68 
local (See Local workstations.) 
logon, 6-10 
remote (See Remote workstations.) 
startup procedures, 6-10 

WS operand, TRUNK macro, 2-157 


Telcon network, A-24 X 
use, 2-161 
XEU statement, A-6 
XLATE operand 
W LINE macro, 2-78 


TERM macro, 2-152, A-23 
translation tables, 4-14 
X.21 circuit-switched PDN, LINE macro, 


Warm restart, 2-19 
WINDOW operand, STATION macro, 2-111 
Window size 2-61, 2-77 
flow control, data packets, 2-157 X.25 link access procedure, VLINE macro, 
permanent virtual circuits, 2-100 2-164 
switched virtual circuits, 2-115 
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